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PREFACE 


MANUAL OBJECTIVES 


This reference manual describes the utility programs supported by 
Record Management Services for PDP-11l operating systems (RMS-11). 


INTENDED AUDIENCE 
This manual is intended for users who either do not require or do not 
have access to full RMS-11 capabilities: high-level language 


programmers, and nonprogramming users such as system managers’ and 
operators. 


STRUCTURE OF THIS DOCUMENT 

This document is organized into seven chapters and four appendixes: 
@e Chapter 1, Introduction 
e Chapter 2, RMS-1]1 File Design Utility: RMSDES 
e Chapter 3, RMS-11 Indexed File Load Utility: RMSIFL 
e Chapter 4, RMS-11 File Conversion Utility: RMSCNV 
@e Chapter 5, RMS-11 File Display Utility: RMSDSP 
e Chapter 6, RMS-11 File Back-Up Utility: RMSBCK 
e Chapter 7, RMS-11 File Restoration Utility: RMSRST 
@e Appendix A, RMS-11 File Definition Utility: RMSDEF 
e Appendix B, RMSDES Area Definition 
e Appendix C, RMS-11 Command Utilities Messages 


e Appendix D, Sort Routine Error Codes 


ASSOCIATED DOCUMENTS 


To use the RMS-11 utilities, you should be familiar with the concepts 
and user information in RSX-11M/M-PLUS RMS-1l: An Introduction and 
the RSX-11M/M-PLUS RMS-1l User's Guide. The introduction presents the 
major concepts of RMS-11, and the user's guide provides detailed user 
information for programmers who want to use RMS-1l, from either 
high-level language programs or MACRO-11 programs. 
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In addition, RSX-11M/M=PLUS RMS-11 Macro Programmer's Guide provides 
programmer information on RMS-11 operations for MACRO-11 programmers; 
and the RSX-11M/M-PLUS RMS=-11 Mini-Reference Insert summarizes, for 
easy reference, the RMS-11 utilities and error codes. 


CONVENTIONS USED IN THIS DOCUMENT 


Convention 


UPPERCASE WORDS 
AND LETTERS 


lowercase words 
and letters 


quotation marks (") 
apostrophes (') 


[ ] 


DES: SHOW FILE 
ATTRIBUTE: NAME 


Meaning 


Uppercase words and letters used in 
examples indicate that you should type _ the 
word or letter exactly as shown. 


Lowercase words and letters used in examples 
indicate that you are to substitute a word or 
value of your choice. 


The term “quotation marks" refers to double 
quotation marks ("). The term “apostrophe" 
refers to a single quotation mark ('). 


Square brackets indicate that the enclosed 
item is optional. 


Braces are used to enclose lists from which 
one element is to be chosen. 


A horizontal ellipsis indicates that the 
preceding item(s) can be repeated one or more 
times. For example: 


file-spec[,file-spec...] 


A vertical ellipsis indicates that not all of 
the statements in an example or figure are 


a er 
DLLVWlie 


In examples of commands you enter and system 
responses, all output lines and prompting 
characters that the system prints or displays 
are shown in black letters. All the lines 
that you type are shown in red letters. 


A symbol with a 1- to 3-character 
abbreviation indicates that you press a key 
on the terminal. 


The symbol CTRL/x indicates that you must 
press the key labeled CTRL while you 
simultaneously press another key (for 
example, <CTRL/C>, <CTRL/Y>, <CTRL/O>). In 
examples, this control key sequence is’ shown 
as “x (for example, “C, “Y, “0) because that 
is how the system echoes control key 
sequences. 


Unless otherwise noted, all numeric values are represented in decimal 


notation. 


Unless otherwise specified, you terminate commands by pressing’ the 


RETURN key. 
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SUMMARY OF TECHNICAL CHANGES 


The RMS-11 File Design Utility (RMSDES) is a new utility that allows 
you to interactively design and create files. RMSDES supersedes the 
RMS-11 File Definition Utility (RMSDEF). 


The RMS-11 File Display Utility (RMSDSPY provides more information 
about magnetic tape files and about back-up files on disk and on 
magnetic tape (container files), and provides an optional detailed 
display for back-up files. The displays also appear in a more 
readable format, and the size field shows both the allocated and used 
sizes of the file. 


The /DE switch to the RMS-1l Indexed File Load Utility (RMSIFL) has 
been enhanced to allow specification of a different device for 


RMSIFL‘s temporary files. 


The /SL switch to the RMS-l1l1 File Conversion Utility (RMSCNV), the 
File Back-Up Utility (RMSBCK), and the File Restoration Utility 
(RMSRST) has been modified to append summary listings of processing to 
a single file if that file exists. 


Five switches have been added to the RMS-1l File Conversion Utility 
(RMSCNV) : the /CA switch, the /EO switch, the /IM switch, the /KN 
switch, and the /ML switch. The /CA switch creates an output file 
with the attributes of an existing file; the /EO switch changes ASCII 
stream files that end with a CTRL/Z character to end with null 
characters; the /IM switch reads and writes records in block mode; 
the /KN switch reads an indexed file using a key name; and the /ML 
Switch explicitly sets the limit of memory allocation. The /PD switch 
no longer requires a number sign (#) before an octal padding character 
or quotation marks around an ASCII padding character unless it is 
lowercase, a space, or a tab. 


In addition, RMSCNV file conversion operations can now specify files 
on remote nodes. On systems with DECnet network capabilities and on 
which RMSCNV has Data Access Protocol (DAP) support, RMSCNV file 
conversions can take place not only locally, but over the network as 
well. You can convert files between a local and a remote node, or 
between two remote nodes. 


One switch has been added to the RMS-11 File Restoration Utility 
(RMSRST) : ICN. The /CV switch converts file version numbers from 
octal to decimal for files created and backed up on RSX-11M/M-PLUS 
systems and restored to VAX/VMS systems; and from decimal to octal 
for files created and backed up on VAX/VMS systems and restored _ to 
RSX-11M/M-PLUS systems. 


All utilities now display information in lowercase letters, and the 


error message format for all utilities (except RMSDEF) has been 
changed (see Appendix C). 
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CHAPTER 1 


INTRODUCTION 


RMS-11 utilities allow you to define, manipulate, and maintain RMS-1l1l 


files. The utilities are provided as independent tasks and are 
designed for users -- for example, high-level language programmers, 
system managers and operators -- who either do not require or do not 


have access to the full RMS-11 capabilities. 
The RMS-11 utilities are: 
@ RMS-11 File Design Utility (RMSDES) 

RMSDES allows you to design and create indexed, sequential, 
and relative files. You can either specify the file 
attributes interactively or read in the attributes of an 
existing, external data file that you want to re-create with 
little or no modification. 


@ RMS-11 Indexed File Load Utility (RMSIFL) 


RMSIFL reads records from any type of RMS-l1l file and loads 
them into an indexed file. 


@ RMS-11 File Conversion Utility (RMSCNV) 


RMSCNV reads records from an RMS-11 file of any type and loads 
them into another RMS-11 file of any type. 


@ RMS-11 File Display Utility (RMSDSP) 
RMSDSP displays a concise description of any RMS-1l file, 
including RMS-11 back-up files on disk or on magnetic tape 
(container files). 

@e RMS-11 File Back-Up Utility (RMSBCK) 
RMSBCK transfers the contents of any RMS-11l disk file to 
another disk or to magnetic tape to maintain the file should 
the original file be lost or damaged. 


@e RMS-11 File Restoration Utility (RMSRST) 


RMSRST transfers, to disk, files that were backed up on 
Magnetic tape or disk using RMSBCK. 


® RMS-11 File Definition Utility (RMSDEF) 


RMSDEF allows you to define the attributes of a file. 
Although this utility has been superseded by the RMSDES 
utility, it is available to users and is documented in 
Appendix A. 


INTRODUCTION 


Help Text and Error Messages. The interactive utilities (RMSDES and 
RMSDEF) provide error messages and help text for each prompt for 
input. The command utilities (RMSIFL, RMSCNV, RMSDSP, RMSBCK, and 
RMSRST) each have a single help text and share a set of common error 
messages. The command utilities' error messages are documented in 
Appendix C. RMSDES and RMSDEF error messages are documented in 
Chapter 2 and Appendix A, respectively. 


Intersystem File Transfer. On systems with DECnet network 
capabilities and on which RMSCNV has Data Access Protocol (DAP) 
support, RMSCNV file conversions can take place not only locally, but 
over the network as well. You can convert files between a local and a 
remote node, or between two remote nodes. 


For example, working on an RSX-11M/M-PLUS system, you can convert 
files to which you have access between your system and another 
RSX-11M/M-PLUS system. Or, you can convert files from your 
RSX~11M/M-PLUS system to either a RSTS/E or VAX/VMS system, or between 
a RSTS/E system and a VAX/VMS system. 


See the RSX-11M/M-PLUS RMS-11 User's Guide for more information on 
RMS-11 remote access capabilities. See Chapter 4 for more information 
on RMSCNV. 


You can also use RMSBCK and RMSRST to transport files between 
different systems. RMSBCK preserves the RMS-11 file attributes when 
you back up files to disk or magnetic tape; the file can thus be 
transported and restored, using RMSRST, to another operating system. 
See Chapter 7 for more information on restoring files to different 
operating systems. 


Note that you can use RMSDSP to display an RMS-ll back-up file's 
attributes and determine which operating system the file was created 
and backed up on. See Chapter 5 for more information on RMSDSP. 


CHAPTER 2 


RMS-11 FILE DESIGN UTILITY: RMSDES 


The RMS-1l1 File Design Utility (RMSDES) is an interactive utility that 
allows you to design and create RMS~11l files to contain data records. 


You design a file by defining the file's attributes. When you create 
a file, a file is built that has those attributes and can store data 
records as required by your program(s). 


To design a file using RMSDES, you issue RMSDES commands to. set, 
reset, clear, and display file attribute values in the RMSDES design 
buffer. This is called a design session. The attributes consist of 
the standard RMS-1l1 attributes, such as file organization and record 
format, plus some additional, informational attributes required by 
RMSDES, such as target system. 


The design buffer is an RMSDES work space that you use to design your 
files. It is divided into five sections: system, file, record, key, 
and area. Each section defines a group of file attributes. For 
example, in the file section, you define attributes such as file name, 
organization, and owner; in the record section, you define attributes 
such as record size, format, and carriage control. 


The functional grouping of attributes in the design buffer makes it 
easy to define, change, or display any attribute or group of 
attributes. See Section 2.6 for a complete description of each buffer 
section and the file attributes defined in each section. 


You gain access to the design buffer and initiate a design session 
when you invoke RMSDES. At the beginning of a design session, the 
file attributes are initialized to RMS-1l default values. You can set 
file attributes either interactively from your terminal by using the 
SET command, or from an external file by using the GET command. 


If you are designing your file interactively, you can either 
explicitly set the attributes to values that you specify, or you can 
accept the default values. If you are designing an indexed file, you 
can either explicitly define areas or allow RMSDES to define them by 
default. 


If you use the SET command to design a file interactively, you will be 
prompted for attribute values. RMSDES prompting is conditional; you 
are prompted only for attributes that pertain to your file design. 
For example, you will be prompted for cluster size only if you have 
set the target system to RSTS/E. 


If you are designing a file using an external file, RMSDES sets’ the 
attribute values in the design buffer to match those in the external 
file. This is useful if you want to duplicate an existing file's 
design. 


RMS-11 FILE DESIGN UTILITY: RMSDES 


You can display file attributes by using the SHOW command. You can 
change attribute values at any time during the design session by using 
either the SET command (to set a new value) or the CLEAR command (to 
restore the default value). 

You can save the file design in a description file by using the SAVE 
command, or you can create an empty data file by using the CREATE 
command. 


Throughout a design session, you can get online assistance by typing a 
question mark (?) or the HELP command. 


Sections 2.1 and 2.2 describe how to invoke and terminate RMSDES-~ and 
how to use the RMSDES commands. Section 2.3 describes how to use the 
design buffer to design a file. Sections 2.4 and 2.5 describe saving 
designs and creating empty data files. Section 2.6 describes the 
buffer sections and file attributes. 


This chapter also provides examples (Section 2.7) and documents” the 
RMSDES messages (Section 2.8). 


2.1 INVOKING AND TERMINATING RMSDES 


RMSDES can be either installed or uninstalled. If RMSDES is 
installed, invoke it with the command: 


DES 


If RMSDES is uninstalled on RSX-11M/M-PLUS systems, invoke it with the 
MCR command: 


RUN SRMSDES 

RMSDES will respond with the prompt: 
DES: 

You can now type any of the RMSDES commands. 

You can install RSMDES with another name as follows: 
INS SRMSDES/TASK=...xxx 


where xxx is a 3-character name that you chose for the utility. The 
utility will then prompt: 


XXX> 


To terminate RMSDES, type one of the following commands in response to 
the DES: prompt: 


QUIT 
<CTRL/Z> 
EXIT file-spec 
The QUIT and CTRL/Z commands terminate RMSDES, and the system prompt 


iS returned. Uniess you have saved the file design or created an 
empty data file, the information in your design buffer will be lost. 


RMS-11 FILE DESIGN UTILITY: RMSDES 


The EXIT command saves the file design in the specified file, 
terminates RMSDES, and the system prompt is returned. 


Section 2.2 describes the RMSDES commands and their formats. 


2.1.1 Invoking RMSDES to Create a Data File from an Existing File 


You can also invoke RMSDES to create an empty data file from an 
existing description or data file by typing the following in response 
to the system prompt: 


DES filename[.typ] [kind] 


The default file type is .DES. The file kind is either DES (for a 
description file) or DAT (for a data file). The default kind is DES 
and need not be specified. After this command is executed, the system 
prompt will be returned. 


The file that is created will have the same attributes as the external 
fi be. If the external file is a description file, the newly created 
file will have the same file name and type that are set in the 
description file. If no il mame and type are specified in the 
1 


file 
description file, the file will be created as FILE.DAT. 
If the external file is a data file, the new data file will have the 
same file name and type as the existing file and a version number 1 
higher than the existing data file. 


See also Sections 2.3.2 and 2.5 for more information on using external 
files and on creating empty data files. 


2.1.2 Invoking RMSDES Using Indirect Command Files 


You can execute series of RMSDES commands by means of indirect command 
files. The commands in an indirect command file are executed when an 
at sign (@) followed by the file's name is specified to the utility. 
The default file type of .CMD is assumed if none is provided. 


Installed RMSDES will accept indirect command files either from the 
system prompt or from the utility prompt. For example, to execute the 
commands in the indirect command file DESCOM.CMD, you could type: 


DES @DESCOM 
or 
DES: @DESCOM 


Uninstalled RMSDES will accept indirect command files only from the 
utility prompt. For example: 


DES: @DESCOM 


RMSDES will access the indirect command file and execute the commands. 
If you executed the indirect command file from the system prompt, the 
system prompt will be returned. 


If you executed the indirect command file from within RMSDES, the DES: 
prompt will be returned, so you can continue the design session, if 
desired. Note, however, that any attributes that were set or reset as 
a result of executing the indirect command file from within RMSDES 
will remain set in the design buffer. 


RMS-11 FILE DESIGN UTILITY: RMSDES 


You can issue a SHOW ALL command after indirect command file execution 
to determine the attribute settings in the design buffer. You might 
also want to include a CLEAR ALL command at the end of the indirect 
command file so that all the attributes are reset to their initial 
default values at the end of indirect command file execution. 


You cannot nest indirect command files run from RMSDES; that is, an 
indirect command file cannot contain a command calling another 
indirect command file. 

You can include comments, using semicolons (;) or exclamation points 


(!), in indirect command files run from either the system prompt or 
the utility prompt. 


2.2 RMSDES COMMANDS 

Table 2-1 summarizes the RMSDES commands, their formats, and their 
functions. You can abbreviate commands as long as the characters 
typed uniquely identify the command. 


The sections that follow Table 2-1 describe the commands and their 
formats, in alphabetical order. 


Table 2-1: RMSDES Commands 


Command Format and Function 


CLEAR CLEAR ALL 


Restores all attribute values in all sections to 
their default values. 


CLEAR section ALL 


Réstores all attribute values in the specified 
section to their default values. 


CLEAR section attribute 


Restores the specified attribute value in the 
specified section to its default value. 


CREATE CREATE [filename[.typ]] 


Creates an empty data file that has the attribute 
values specified in the design buffer. For indexed 
files in which areas are not defined, prompts for 
whether areas are to be defined by default. 


If you do not specify a file name and type, the file 
will have those specified in the design buffer. If you 
did not specify a file name and type in the design 
buffer, the file will be created as FILE.DAT. 


CTRL/Z <CTRL/Z> 


Terminates RMSDES without saving the design or creating 
an empty data file. 


Command 


ESC 


EXIT 


GET 


HELP 
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Table 2-1 (Cont.): RMSDES Commands 


Format and Function 


In response to any prompt, returns the DES: prompt 
and preserves all attribute values in the design 
buffer. 

EXIT filename[.typ] 

Stores the file design in the description file 
specified in the command line and terminates RMSDES. 
The default file type is .DES,. 

GET filename[.typ] [kind] 

Reads the file design specified in a description 
file, and sets the appropriate attribute values in 
the design buffer. Reads the attribute values of a 


data file, and sets the appropriate attribute values 


in the design buffer. The default file kind is DES. 
If the file is a data file, kind must be specified: 
DAT. 
HELP 


Lists all available help topics and gives instructions 
for displaying the text. 


HELP COMMANDS 

Lists the valid commands for which help is available. 
HELP command 

Displays help text for the specified command. 

HELP SECTIONS 


Lists all available help topics for all sections and 
gives instructions for displaying the text. 


HELP section 


Lists all available help topics for all attributes in 
the specified section. 


HELP section attribute 


Displays help text for the specified attribute in the 
specified section. 


is 


Displays help text for the section, attribute, or value 
for which you are being prompted. 


(continued on next page) 


1. For any form of the HELP command, you can type a question mark (?) 


instead 


HELP. Note that you can type the HELP form only in 


response to the DES: prompt. 
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Table 2-1 (Cont.):  RMSDES Commands 


Command Format and Function 


QUIT QUIT 


Terminates RMSDES, without storing the design or 
creating an empty data file. 


SAVE SAVE filename[.typ] 
Stores the file design in the description file 
specified in the command line. The default file type 
is .DES. 

SET SET ALL 
Prompts for setting all attribute values in all 
sections. For indexed files in which areas are not 
defined, prompts for whether areas are to be defined 
by default. 
SET section ALL 


Prompts for setting all attribute values in the 
specified section. 


SET section attribute value 


Sets the specified attribute value in the specified 
section. 


SHOW SHOW ALL 
Displays all attribute values in all sections. 
SHOW section ALL 


Displays all attribute values in the specified 
section. 


SHOW section attribute 


Displays the specified attribute value in the 
specified section. 


SHOW ID SHOW ID 


Identifies the current version and patch level of 
RMSDES. 


2.2.1 CLEAR Command 


The CLEAR command restores attribute values in the design buffer to 
their initial default values. You can clear attribute values for all 
sections, for one section, or for one attribute. 


You should clear all sections after you have saved or created a _ file; 
the buffer will then be ready to accept a design for another file. 
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Format 


CLEAR AL 
section ALL 


section attribute 
ALL 


Restores all attribute values in all sections to their initial 
default values. 


section ALL 


Restores all attribute values in the specified section to their 
default values. Section must be one of the section keywords 
listed in Table 2-2 (Section 2.3). Note that for this form of 
the command, you must type "ALL" in full ("AL" and "A" are legal 
abbreviations for the Allocate attribute). 


section attribute 


Restores the specified attribute value in the specified section 
to its initial default value. Section and attribute each must be 
one of the keywords listed in Table 2-2 (Section 2.3). 

After RMSDES executes a CLEAR command, the DES: prompt is’ returned. 
If you omit any part of the command string, you will be prompted for 
Le 


Examples 


DES: CLEAR 
SECTION: FILE 
ATTRIBUTE: ORGANIZATION 
DES: 


RMSDES prompts for the omitted section and attribute keywords. 
When the keyword is supplied, the default file organization 
(sequential) is restored. 


DES: CLEAR KEY 2 ALL 
DES: 


This command clears all the attribute values in key 2. Note that 
if you have defined multiple keys (or areas), and you issue the 
CLEAR command, the keys (or areas) will be renumbered and you 
will have one fewer keys (or areas). 


For example, if you have defined keys 0 through 4 and you clear 
key 2, key 3 will become key 2, and key 4 will become key 3. 
Four keys, not five, will now be defined. If you want to change 
the attributes in a key, you should use the SET command to 
replace the previous attribute values with the new ones, without 
altering key numbers. 


2.2.2 CREATE Command 


The CREATE command creates an empty data file that has the attribute 
values specified in the design buffer. The empty data file is capable 
of containing data records for use by your programs. 
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If you create an indexed file for which you defined areas and/or keys, 
the areas and/or keys must be numbered in sequence, starting with 0. 
RMSDES will create only those areas and/or keys that are numbered 
sequentially, starting with 0. For example, if you have defined areas 
0, 1, and 3, only areas 0 and 1 will be created when you issue the 
CREATE command. No error will be returned. 


You can allow RMSDES to define areas in an indexed file by default. 
If you have not defined areas when you issue the CREATE command, you 
will be prompted as to whether you want RMSDES to define areas by 
default: 


Areas defaulted: 


If you respond YES or press RETURN (YES is the default), RMSDES will 
prompt for additional information and define areas based on your 
responses and on the number of keys you specified in the key section. 
See also Section 2.6.5. 


Format 
CREATE [filename[.typ] ] 
filename[.typ] 


Names an empty data file that has the attribute values specified 
in the design buffer. If specified, the file name and type in 
the command string will supersede those specified in the design 
buffer. The default file type is .DAT. 


If you do not specify a file name, the data file will have the 
file name and type specified in the design buffer. If a file 
name and type are not specified in either the design buffer or 
the command line, the file will be created as FILE.DAT. 


After RMSDES executes a CREATE command, the DES: prompt is’ returned. 
If you want to design another file, you should issue a CLEAR ALL 
command to restore the attribute values in the design buffer to their 
defaults. 


Examples 


DES: CREATE 
DES: 


This command creates an empty data file, using the file name and 
type specified in the design buffer. 


DES: CREATE PER.IDX 
Areas defaulted: (él 
Bucket Size (2): (él 

DES: a 


This command creates an empty indexed data file called PER.IDX. 
Areas were not defined in the design buffer, so the user is 
prompted "Areas defaulted:" and presses RETURN in response. 
RMSDES then prompts for bucket size and the user again takes the 
default. RMSDES will define the areas based on a bucket size of 
2 and the number of keys specified in the design buffer. 
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2.2.3 CTRL/Z Command 


The CTRL/Z command terminates RMSDES without saving the file design or 
creating an empty data file. All attribute values in the design 
buffer are lost. 


Format 
<CTRL/Z> 
Examples 


DES: SET RECORD ALL 
Starting RECORD section 
Size (0): 1000 

Format (Var): GAZ 


The CTRL/Z command, typed in response to the format attribute 
prompt, terminates RMSDES. The system prompt is returned and all 
attribute values in the design buffer are lost. 


2.2.4 ESC Command 


The ESC command, entered in response to any RMSDES prompt, returns the 
DES: prompt and preserves all attribute values in the design buffer. 


Format 
<ESC> 


The ESC command is especially useful when you want to interrupt an 
interactive design session. For example, you may want to make changes 
to previously set attributes or to resume your design session later. 
Typing ESC will return the DES: prompt and preserve all attribute 
values in the design buffer. You can then enter any RMSDES command in 
response to the DES: prompt. 


Examples 


DES: SET RECORD ALL 

Starting RECORD section 
Size (0): 1000 
Format (Var): (S80 

DES: 
The ESC command, typed in response to the format attribute 
prompt, returns the DES: prompt. All attribute values in the 
design buffer are saved. 


2.2.5 EXIT Command 

The EXIT command stores your file design in the description file 
specified in the command string. Then, it terminates RMSDES, and the 
system prompt is returned. 


Format 


EXIT filename[.typ] 
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filename[.typ] — 


Names the description file in which the file design will be 
stored. The default file type is .DES. 


Examples 


DES: EXIT 
File Name: 


If you omit the file specification, you will be prompted for it. 
DES: EXIT PERS 
This command stores your file design in a description file called 


PERS.DES and terminates RMSDES. Because the file type, .DES, is 
the default, you can omit it from the command line. 


2-2-6 GET Command 


The GET command sets attribute values in the design buffer based on 


the information it reads from an external file; that is, a 
description file or a data file. A description file contains a file 
design. A data file contains, or is capable of containing, data 


records. The GET command: 


@e Reads the file design specified in a description file and sets 
the corresponding attribute values in the design buffer. (See 
also Section 2.3.2.1.) 


e Reads the attribute values of a data file and sets’ the 
corresponding attribute values in the design buffer. (See 
also Section 2.3.2.2.) 


When you issue a GET command, RMSDES first initializes the file 
attributes in the design buffer to their default values. MThus, anv 
attributes that you may have set before issuing the GET command are 
cleared. Then, RMSDES sets the attribute values in the design buffer 
to match those of the external file. 


Note, however, that if you specify an indexed data file, RMSDES cannot 
access the initial allocation for the areas: the allocation attribute 
for each area will be set to the number of blocks that remain 
available in each area of the data file, not to the initial allocation 
for each area in the data file. You can use the SHOW command to 
display the setting and then use the SET command to reset the 
allocation attribute as necessary. 


If the external file is a data file, the file name and type in the 
design buffer will be set to those of the existing file. If you issue 
a CREATE command, the new data file will have the same file name. and 
type as the existing data file and a version number 1 higher than the 
existing data file. 


Format 
GET filename[.typ] [kind] 

filename[.typj [kind] 
Reads the file attributes from a description file and sets’ the 
corresponding attribute values in the design buffer. The default 


file type is .DES. If the description file was created using 
RMSDES, you need not specify kind (DES is the default kind). 
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GET also reads the attribute values of a data file and sets’ the 
corresponding attribute values in the design buffer. You must 
specify kind as DAT. 

After RMSDES executes a GET command, the DES: prompt is returned. 


Examples 


DES: GET FOO 


DES: 
This command reads the file attributes in FOO.DES, a description 
file created using RMSDES, and sets the corresponding attribute 
values in the design buffer. Because the file type, .DES, and 
kind, DES, are the defaults, they can be omitted from the command 
line. 
DES: GET 
File Name: FOO.BAR DAT 
DES: 


If you omit the file specification, you will be prompted for it. 
This command reads the file attributes in FOO.BAR, a data file, 
and sets the corresponding attribute values in the design buffer. 


2.2.7 HELP Command 


The HELP command displays help text. You can type the HELP form of 
the command only in response to the DES: prompt. You must type the ? 
form in response to any other prompt. In addition, for any form of 
the command, you can type a question mark (?) instead of HELP. 


Formats 
COMMANDS 
command 
SECTIONS 
HELP section 


section attribute 


2 


If you type HELP in response to the DES: prompt, all help topics 
and instructions for displaying the text will be given. 


COMMANDS 
Lists the valid commands for which help is available. 

command 
Specifies a command for which help text is to be displayed. 
Command must be one of the command keywords listed in Table 2-1 
(Section 2.2). 

SECTIONS 


Lists all section help topics and gives instructions for 
displaying the text. 
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section 


Specifies a buffer section for which help text is to be 
displayed. Section must be one of the section keywords listed in 
Table 2-2 (Section 2.3). 


section attribute 
Specifies an attribute and section for which help text is to be 


displayed. Section and attribute must each be one of the 
keywords listed in Table 2-2 (Section 2.3). 


Lhe] 


Displays help text for the section, attribute, or value for which 
you are being prompted. 


After RMSDES executes any form of the HELP command, the prompt from 
which you issued the command is returned. 


Examples 


DES: HELP SYSTEM 


Section Attribute Keyword Default 
Keyword and Variable 


System Target argument 


argument must be one of: 


RSX User's system 
RSTS 
Source User's system 


File Placement 2 logical NO 
In response to the HELP SYSTEM command, RMSDES displays’ the 
system attributes and the default settings for those attributes. 
DES: HELP FILE NAME 
Name string 


Specifies the name of the file. For string, type a file 
specification. 


In response to the HELP FILE NAME command, RMSDES displays 
information on the Name attribute. 


2.2.8 QUIT Command 
The QUIT command terminates RMSDES without creating a description file 


or an empty data file. The attribute values in the design buffer are 
lost. 


1. Not user-settable; RMSDES automatically notes the user's source 
system. 


2. Informational attribute. 
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Format 
OUTT 


After RMSDES executes the QUIT command, the system prompt is returned. 


2.2.9 SAVE Command 


The SAVE command stores the file design in a description file 
specified in the command string. 


Format 
SAVE filename[.typ] 
filename[.typ] 


Names the description file in which the file design will be 
saved. The default file type is .DES. 


If you omit any part of the command string, you will be prompted for 
Lt % After RMSDES executes the SAVE command, the DES: prompt is 
returned. If you want to design another file, you should issue a 


CLEAR ALL command to restore the attribute values in the design buffer 
to their defaults. 


Examples 


DES: SAVE 
File Name: FOO.TYP 


If you omit the file specification, you will be prompted for it. 


DES: SAVE FOO 
DES: 


This command stores the file design in the description file 
FOO.DES. Because the file type, .DES, is the default, it can be 
omitted from the command line. 


2.2.10 SET Command 


The SET command sets attribute values in the design buffer. You can 
set an individual attribute value or you can set attribute values for 
all sections or for one section. Note that prompting for attributes 
will be conditional based on the target system, file organization, and 
record format that you specify (either explicitly or by default). For 
example, you will be prompted for cluster size only if you have 
specified the target system as RSTS/E. 


Format 
SET ALL 
section ALL 
section attribute value 
ALL 


Specifies that you want to be prompted for all attribute values 
in all sections. 
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When you reach the area section, you will be prompted as_ to 
whether you want RMSDES to define areas by default: 


Areas defaulted: 


If you respond YES or press RETURN (YES is the default), RMSDES 
will prompt for additional information and define areas based on 
your responses and on the number of keys you specified in the key 
section (see Section 2.6.4). Appendix B describes how RMSDES 
defines areas by default. 


section ALL 


Specifies that you want to be prompted for all attribute values 
in the specified section. Section must be one of the section 
keywords listed in Table 2-2 (Section 2.3). Note that if you use 
this form of the command, you must type "ALL" in full ("AL" and 
"A" are legal abbreviations for the Allocate attribute). 


For the key and area sections, you will be asked for the number 
of keys or areas you want to define. After you specify the 
number of keys or areas, you will be prompted for the attribute 
values of all the keys or areas you specified. See Sections 
2.6.4 and 2.6.5. 


section attribute value 


Specifies that you are setting the specified attribute value in 
the specified section. Section and attribute each must be 
keywords and value must be one of the variables listed in Table 
2-2 (Section 2.3). 


After RMSDES executes the SET command, the DES: prompt is returned. 
If you omit any part of the command string, you will be prompted for 
Ee 


Examples 


DES: SET FILE NAME 
VALUE: 


If you omit the section or attribute keyword or the value, you 
will be prompted for it. 


DES: SET FILE NAME FOO.BAR 
DES: 


This command names the file FOO.BAR. 


DES: SET ALL 


In response to this command, you will be prompted for all 
attributes in all sections. Note that the prompting will be 
conditional; for example, if you type RSX in response to the 
target prompt, you will not be prompted for a cluster size value, 
which is required only if the target system is RSTS/E (see 
Section 2.6). 
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DES: SET FILE ALL 


In response to this command, you will prompted for all attributes 
in the file section. Note that the prompting for file attributes 
will be conditional based on the file organization and format 
that you specify. For example, if you specify that the file 
organization is indexed, you will not be prompted for a magnetic 
tape block size value (see Section 2.6). 


2.2.11 SHOW Command 


The SHOW command displays attribute values. You can display an 
individual attribute value or you can display attribute values for all 
sections or for one section, Note that the display will be 
conditional; that is, only the attributes for which you were prompted 
by the SET command will be displayed (see Section 2.2.10). The 
display also indicates whether attribute values were set explicitly or 
by default. 


Format 
SHOW ALL 
section ALL 
section attribute 
ALL 
Displays all attribute values in all sections. 
section ALL 
Displays all attribute values in the specified section. Section 
must be one of the section keywords listed in Table 2-2 (Section 
2.3). Note that if you use this form of the command, you must 
type "ALL" in full ("AL" and "A" are legal abbreviations for the 
Allocate attribute). 


section attribute 


Displays the specified attribute value. Section and attribute 
must be keywords listed in Table 2-2 (Section 2.3). 


After RMSDES executes the SHOW command, the DES: prompt is’ returned. 
If you omit any part of the command string, you will be prompted for 
it. 


Examples 


DES: SHOW FILE 
ATTRIBUTE: 


If you omit the section, attribute, or value keyword, you will be 
prompted for it. 


DES: SHOW FILE NAME 
NAME FOO.BAR (Explicit) 
DES: 


This command displays the name of the file, FOO.BAR, and 
indicates that the file name was set explicitly. 
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DES: SET FILE NAME INFILE.DAT 
DES: SET FILE ORGANIZATION INDEXED 
DES: SHOW FILE ALL 


FILE 
Name INFILE.DAT (Explicit) 
Organization INDEXED (Explicit) 
Allocation 0 
Extension 0 
Bucket Size 1 
Protection 
Owner {303,24] 
Max Record Number 0 
Contiguous NO 
Supersede NO 


This command displays attribute values in the file section. 


2.2.12 SHOW ID Command 


The SHOW ID command displays the current version of the RMSDES 
utility. You can type SHOW ID with the DES command (in response to 
the system prompt), or in response to the DES: prompt (after you have 
invoked RMSDES). 


The last two digits of the version number are the patch level of the 
utility. 


Format 
SHOW ID 


After RMSDES executes the SHOW ID command, the prompt from which you 
issued the command will be returned, 


Examples 


DES SHOW ID 
%DES-I-ID, Version 2.000 


Typed in response to the system prompt, SHOW ID displays’ the 
RMSDES version number. The last two digits (00 in this example) 
are the patch level. The system prompt will be returned after 
the version number is displayed. 


DES: SHOW ID 
DES: 


In this example, SHOW ID is typed in response to the DES: 
prompt, which is returned after the command is executed. 


2.3 USING THE RMSDES BUFFER TO DESIGN FILES 


The RMSDES design buffer is a work space that you use to design files 
and to fine tune your designs. The design buffer is divided into five 
sections: system, file, record, key, and area. Each of these 
sections contains file attributes that can be set to specific values. 
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Table 2-2 lists the attributes grouped within each design buffer 
section. Section 2.6 describes the sections and attributes of the 
design buffer in greater detail. 


When you begin a design session, all design buffer attributes are 
initialized to default values. Most of the attributes in the design 
buffer are RMS-11 file attributes and are initialized to RMS-11 
default values. Some attributes, however, such as target system, are 
informational attributes required by the RMSDES utility. 


Table 2-2 lists the defaults assigned to each attribute when you begin 
a design session and indicates whether the attribute is informational. 
In designing a file, you can set these attributes to specific values 
that you supply, or you can accept the default values (by pressing 
RETURN). 


You can set attribute values interactively by using the SET command. 
You will be prompted conditionally so that you set only the attributes 
that pertain to your file design. For example, if you specify RSX as 
your target system, you will not be prompted for cluster size (which 
is required only if the target system is RSTS/E). 


You can also set attribute values by using the GET command to_ load 
into the design buffer either (1) a file design from a description 
file or (2) the attribute values of a data file. The attribute values 
that you specify, either interactively or from external description or 
data files, replace the initial RMSDES default values. Section 2.3.1 
describes setting attribute values interactively. Section 2.3.2 
describes setting attribute values using external files. 


Attribute values that are not replaced by user-set values (by use of 
either the SET or GET command) retain default values. You can also 
allow RMSDES to automatically define areas in an indexed file. 


If you issue a SET ALL command for indexed files, RMSDES will prompt 

you when you reach the area section. You will also be prompted ‘if you 

issue a CREATE command but have defined no areas for an indexed file: 
Areas defaulted: 


You can respond YES or NO: 


e To define areas explicitly, type NO. If you issued a SET ALL 
or SET AREA ALL command, RMSDES will prompt you: 


Number of areas: 


Type a decimal number to specify the number of areas you want 
to define. RMSDES will prompt you for each attribute in every 
area you are defining. Areas will be numbered sequentially 
starting with 0. 


Tf you define no areas but issue a CREATE command, the file 
will be created with a single area (the RMS-11 default). 


e To define areas by default, type YES or press RETURN (YES is 
the default). RMSDES will prompt you: 


Bucket Size (2): 


Type a decimal number to indicate bucket size (the default is 
2). 


When you issue a CREATE command, RMSDES will define areas by 
default based on this bucket size and the number of keys you 
specified in the key section. 
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See also Section 2.6.5 for more information on allowing RMSDES to 
define areas by default. 


In addition, you can clear and display attribute values during a 
design session by issuing a CLEAR or SHOW command. See Sections 2.3.3 
and 2.3.4. 


At the end of the design session, to capture the file that you have 
designed in the design buffer, you must save the design with the SAVE 
or EXIT command (see Section 2.4) or create the data file with the 
CREATE command (see Section 2.5). If you terminate the design session 
with the QUIT or CTRL/Z command, the information in the buffer will be 
lost. 


Table 2-2: RMSDES Section and Attribute Keywords 


Section Attribute Keyword Default 
Keyword and Variable 


System TARGET! argument 


argument must be one of: 


RSX User's system 
RSTS 
source! 2 User's system 
FILE PLACEMENT! logical NO 
File NAME string FILE.DAT 


ORGANIZATION argument 


SEQUENTIAL SEQUENTIAL 
RELATIVE 
INDEXED 


CLUSTER SIZE number (RSTS/E only) 0 blocks 


ALLOCATION number 0 blocks 
EXTENSION number 0 blocks 
BUCKET SIZE number 1 block 
PROTECTION string System protection 


OWNER string (RSX-11M/M-PLUS only) User's UIC 


(continued on next page) 


l. Informational attribute. 


2. Not user settable; RMSDES automatically notes the user's source 
system. 
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Table 2-2 (Cont.): RMSDES Section and Attribute Keywords 


Section Attribute Keyword Default 

Keyword and Variable 

File MAGTAPE BLOCK SIZE number 512 bytes 
REWIND MAGTAPE logical NO 
MAX RECORD NUMBER number 0 records 
CONTIGUOUS logical NO 
SUPERSEDE logical NO 

Record SIZE number 0 bytes 


FORMAT argument 


argument must be one of: 


VARIABLE VARIABLE 
STREAM 
FIXED 
VFC 
CONTROL FIELD SIZE number 2 bytes 
BLOCK SPAN logical YES 


CARRIAGE CONTROL argument 


argument must be one of: 


CARRIAGE RETURN CARRIAGE RETURN 
FORTRAN . 
NONE 

Key nl NAME string No name 


TYPE argument 
argument must be one of: 


STRING STRING 
BIN2 

BIN4 

INT2 

INT4 

DECIMAL 


NULL KEY logical NO 


(continued on next page) 


1. You must specify a number (n) for each key, key segment, and/or 
area you define. 
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Table 2-2 (Cont.): 


RMSDES 


RMSDES Section and Attribute Keywords 


Section Attribute Keyword 
Keyword and Variable 
Key nl NULL VALUE argument 


argument must be one of: 


An ASCII character 
A decimal number 


DUPLICATES logical 


SEGn POSITION! number 


SEGn_ LENGTH! number 


SEGO POSITION number 


CHANGES logical 


DATA FILL number 


DATA AREA number 


INDEX FILL number 


LEVEL1 INDEX AREA number 


INDEX_AREA number 


Area nt ALLOCATION number 


a? 


BPATLNSION umber 


BUCKET SIZE number 


CONTIGUOUS logical 


POSITION argument 


argument must be one of: 


NONE 


Default 


" ' (space) 

NO (primary key) 
YES (alternate key) 
Byte 0 

0 bytes 

Byte 0 

YES (alternate key) 
100 % 


Area 0 


NO 


NONE 


VIRTUAL number (RSX-11M/M-PLUS only) 
LOGICAL number 


EXACT POSITIONING logical (RSX-11M/M-PLUS only) NO 


1. You must specify a number (n) 


area you define. 


You use the SET command 


in the design buffer individually, 


-1 Setting Attribute Values 


(Section 2.2.10) to specify 
in one section, 


for each key, key 


segment, 


attribute 


and/or 


values 


or in all sections. 


RMS-11 FILE DESIGN UTILITY: RMSDES 


2.3.1.1 Setting Individual Attribute Values - When you issue the SET 
command for an individual attribute, the command is executed to set 
the specified attribute and the DES: prompt is returned. For 
example: 


You can accept the default for an attribute by omitting the value from 
the command string and pressing RETURN in response to the VALUE: 
prompt. The following examples illustrate how to set the individual 
attribute values for a l-segment primary key (key 0). 


DES: SET KEY 0 TYPE 
VALUE: ED 


Pressing RETURN in response to the VALUE: prompt specifies the 
default for TYPE (STRING). 


DES: SET KEY 0 SEGO POSITION 0 


DES: 
The SET command specifies that the first byte of the primary key will 
begin at byte 0 of the record. 


DES: SET KEY 0 SEGO LENGTH 5 


The SET command specifies that the primary key will be 5 bytes long. 


2.3.1.2 Setting Attribute Values in Sections - When you issue the SET 
section command, RMSDES will prompt you for attribute values in that 
section only. When you issue the SET ALL command, RMSDES will prompt 
you for attribute values in all sections. 


Note that the prompting will be conditional based on your 
specifications for target system, file organization, and _ record 
format. That is, you will not be prompted for attributes that do not 
pertain to your file design; for example, you will be prompted for 
cluster size only if your target system is RSTS/E. 


In response to each attribute prompt, you can either type a specific 
value or press RETURN to accept the default. Table 2-2 lists the 
defaults for attributes. 


If you are designing an indexed file, you can allow RMSDES to define 
areas by default based on the number of keys you specified in the key 
section; see Section 2.6.5. 


When you issue the SHOW ALL, SAVE, or CREATE command, RMSDES_ will 
assign the user-set and default attributes you specified in the design 
buffer; see Sections 2.3.4.2, 2.4, and 2.5. 


While being prompted for attribute values, you may want to interrupt 
your design session to change previously set attributes, or to save 
your file design and resume the _ session later. Typing ESC will 
interrupt the design session, return the DES: prompt, and preserve 
all attribute values in the design buffer. In response to the DES: 
prompt, you can: 


e Reset previously set attributes -- Use the CLEAR command to 
clear any section or attribute in the design buffer. Then use 
the SET command to reset them. 
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e Resume the design session -- Use the SET section command to 
return to the section in which you were setting attributes. 
Once the attribute prompt returns, press RETURN until you 
reach the attribute at which you left the design session; the 
attribute values you set earlier will be preserved. Then set 
attribute values as usual. 


e Save the design -- Use the SAVE command to store your design 
in a description file. To resume your design session later, 
use the GET command to load the file design in the description 
file into the design buffer. 


e Begin a new design session -- Use the CLEAR ALL command. to 
clear the whole buffer. Then issue the appropriate SET 
command and design your file. 


When attribute prompting is completed, the DES: prompt is’ returned. 
You can then: 


@e Use the SHOW command to display attribute values 
e Use the SET command to set or reset more attribute values 


e Use the CLEAR command to restore any attribute, section, or 
sections to their default values 


e Use the SAVE command to save the file design 


e Use the EXIT command to save the file design and terminate 
RMSDES 


e Use the CREATE command to create an empty data file 


@e Use the QUIT command to terminate RMSDES (attribute values in 
the design buffer will not be saved) 


Example 


The following example illustrates how you are prompted for and can set 
attribute values using the SET ALL command. It also illustrates the 
use of the ESC command to interrupt the design session to reset an 
attribute value. 


DES: SET ALL 
Starting SYSTEM section 
Target: RSX 
File Placement: 4&1 
Starting FILE section 
Name: PERS.DIS 
Organization (Seq): (El 


Pressing RETURN specifies the defaults: NO for file placement and 
sequential for file organization. 


Allocation (0): 2 
Extension (0):  €80 
DES: 


You realize that you should have specified the default (NO) for 


Allocation. Typing ESC interrupts the design session, returns the 
DES: prompt, and preserves all previously set attribute values. To 


verify the Allocation setting, use the SHOW command: 


DES: SHOW FILE ALLOCAT 
ALLOCATION 2 (Explicit) 
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The SHOW command displays the value set for the allocation attribute. 
You specified 2 bytes instead of the default, 0. 


DES: CLEAR FILE ALLOCATION 
DES: 


The CLEAR command restores the default for Allocation, 0. 


DES: SET ALL 


The SET ALL command resumes the design session. 


Starting SYSTEM section 
Target: 
File Placement: 2€ 
Starting FILE section 
Name: 
Organization (Seq): él 
Allocation (0): (REL 


Pressing RETURN preserves the previously set values. 


Rewind Magtape (NO): él 


You can now continue your design session, and will be prompted for the 
remainder of the file section, as well as for all other sections. 
Note that in this example, you will be prompted for whether’ the 
magnetic tape is to be rewound because you specified sequential file 
organization earlier. resSing RETURN in response to this prompt 
specifies the default, NO. 


NOTE 


When RMSDES prompts for attribute 
values, it always displays the same 
default value; it does not show the 
current value which you may have set in 


the design buffer. You must issue a 
SHOW command to determine the current 
value. 


In addition, note that a carriage return 
in response to a prompt will not change 
any existing value which has been set in 
the design buffer. 


Under these circumstances, RMSDES will 
prompt for a value, displaying a default 
value. Responding with a carriage 
return will mean that a previously set 
value is used by RMSDES, not the default 
value that was displayed. 
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2.3.2 Setting Attribute Values Using External Files 


You use the GET command (Section 2.2.6) to direct RMSDES to read 
attribute value information from an external file and to set the 
corresponding attributes in the design buffer. 


When you issue a GET command, RMSDES first initializes the attributes 
in the design buffer to their original (default) values, and then 
reads in the attribute value information from the external file. 


RMSDES reads attributes from two kinds of external files: 


@ Description file -- an ASCII sequential file that contains a 
file design; that is, it contains file attribute values set 
in a design session. 


@e Data file --~ a file that contains or is capable of containing 
data records. RMSDES ignores any data records that the file 
may contain, loading only the attributes of the data files 
into the design buffer. 


Sections 2.3.2.1 and 2.3.2.2 describe how description and data files 
are used. 


Reading attribute values from an external file into the design buffer 
allows you to: 


@e Redesign some attributes of a file to improve its efficiency, 
and then to save the design or create the empty data file. 


@ Create an empty data file from the file design specified in a 
description file. 


e Create an empty data file from the attributes of a data file. 
This allows you to use the data file as a template to copy the 
structure of a file without copying the records. 
e Create a description file from tne attributes of a Gata fiie. 
Once the attribute values are set in the design buffer, you can: 


e Use the SHOW command to display the attribute values of the 
file 


e Use the SET command to redesign the file 


e Use the SAVE command to save the file design in a description 
file 


e Use the CREATE command to create an empty data file 


2.3.2.1 Setting Attribute Values from a Description File - The 
following examples show how to load into the design buffer the file 
design attributes contained in description files created using RMSDES. 


DES: GET FOO 
DES: 


This command loads the file design attributes of FOO.DES into’ the 
design buffer. (The default file type, .DES, and default file kind, 
DES, need not be specified.) 


DES: GET FOO.BAR 
DES: 
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This command loads the file design attributes of FOO.BAR into’ the 
design buffer. The file type must be specified because it is not the 
default. However, the kind, DES, need not be specified; RMSDES will 
assume that the file was created using RMSDES if no type is specified. 


2.3.2.2 Setting Attribute Values from a Data File - Loading the 
attributes of a data file into the design buffer makes it possible for 
you to rapidly set attribute values in the design buffer without going 
through the whole design sequence. Once the attribute values are set 
in the buffer, you can change the file design, save the design, or 
create a new, empty data file. Once the new data file is created, you 
can store records in it. 


Note, however, that if you specify an indexed data file, RMSDES cannot 
access the initial allocation for the areas: the allocation attribute 
for each area will be set to the number of blocks that remain 
available in each area of the data file, not to the initial allocation 
for each area in the data file. You can use the SHOW command. to 
display the setting and then use the SET command to reset the 
allocation attribute as necessary. 


If the external file is a data file, the file name and type in the 
design buffer will be set to those of the existing file. If you issue 
a CREATE command, the new data file will have the same file name and 
type as the existing data file and a version number 1 higher than the 
existing data file. 


Reading the attributes of a data file into the design buffer is useful 
in the following cases: 


e A file that you use processes records efficiently. As a 
result, you want to duplicate its file design. After loading 
the attributes of that data file into the design buffer with 
the GET command, you can save the design or create an empty 
data file. This procedure allows you to use the original data 
file as a template to save or copy the structure of the file 
without copying the records. 


e A file that you use is largely efficient, but a few of the 
attributes need to be reset. After loading the attributes of 
the data file into the design buffer, you can rapidly make 
changes with the SET command. You can then save the design or 
create an empty data file. 


For example: 


DES: GET FOO.BAR DAT 
DES: 
s co d loads the attributes of FOO.BAR, a data file, into the 


ma 
u er. 


n 
ce 
ULL 


2.3.3 Clearing Attribute Values 
You use the CLEAR command (Section 2.2.1) to restore the attribute 


values of one attribute, of one section, or of all sections to their 
default values. 


RMS-11 FILE DESIGN OTILITY: RMSDES 


2.3.3.1 Clearing Individual Attribute Values - When you issue the 
CLEAR command for an individual attribute, the attribute value is 
restored to its default. You may want to restore an attribute value 
to its default if you find that the default value would improve your 
file design. 


For example: 


DES: CLEAR RECORD FORMAT 
DES: 


This command restores the record format to the default, VARIABLE. 


2.3.3.2 Clearing Attribute Values in Sections - You clear user-set 
attribute values in sections when values you previously defined are 
incorrect or no longer useful. 


The following example restores all the attributes in the file section 
to their default values: 


DES: CLEAR FILE ALL 
DES: 


You can now use the SET command to reset the attributes in the file 
section. The attributes in the other sections of the design buffer 
will retain the values you have previously set, 


You should also clear all sections after you have saved a file design 
or created a file, as follows: 


DES: CLEAR ALL 
DES: 


The buffer will now be ready to accept a design for another file. 


2.3.4 Showing Attribute Values 


You use the SHOW command (Section 2.2.11) to display the attribute 
values in the buffer individually, in one section, or in all sections. 
Attribute values are displayed conditionally; that is, only the 
attributes that pertain to the file design are shown. For example, a 
cluster size value will be displayed only if you have specified RSTS/E 
as the target system. 


2.3.4.1 Showing Individual Attribute Values - The SHOW command is 
useful when: 


e You are setting an attribute value that depends on a 
previously set attribute value. Displaying the previously set 
attribute value confirms what value is already defined. 


@ You want to confirm that you have set an attribute to the 
correct value. 


The following example shows how to display the file organization 
attribute value: 


Trea m= mar 


INDEXED (Explicit) 


nh CUT LNT. PS eT TN ane 
1 nS : aris OP ba Ge A ree 


ORGANIZATION 
DES: 
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2.3.4.2 Showing Attribute Values in Sections - The SHOW section 
command displays user-set and default attribute values in one section. 
The SHOW ALL command displays attribute values in all sections. 


The SHOW command allows you to: 
e Confirm what attribute values you have set. 


e Inspect a file design that is stored in a description file. 
Inspecting the attribute values of the file design gives you 
an accurate profile of the file. 


e Inspect a file that you did not finish designing, but stored 
as an incomplete design session in a description file. 
Inspecting the attribute values of the file design informs you 
what values are already set and defaulted, and where you 
interrupted your design session. 


e Confirm that you are going to clear the right section. For 
example, if your file design contains multiple keys, you might 
want to inspect the specific key section to make sure you are 
going to clear the right key. 


For example: 
DES: SET FILE ORGANIZATION INDEXED 


DES: SET FILE NAME INFILE.DAT 
DES: SHOW ALL 


SYSTEM 
Target RSX 
Source RSX 
FILE 
Name INFILE.DAT (Explicit) 
Organization INDEXED (Explicit) 
Allocation 0 
Extension 0 
Bucket Size 1 
Protection 
Owner [303,24] 
Max Record Number 0 
Contiguous | NO 
Supersede NO 
RECORD 
Size 0 
Format VARIABLE 
Carriage Control CARRIAGE RETURN 


2.4 SAVING THE FILE DESIGN 


When you have completed a design session, you can use the SAVE command 
{Section 2.2.9) or the EXIT command (Section 2.2.5) to store the file 
design in a description file. If you issue a SAVE command, the RMSDES 
prompt will be returned after the file design is stored and you can 
continue the design session. If you issue an EXIT command, RMSDES 
will be terminated and the system prompt will be returned after the 
file design is stored. If, after you save a file design, you want to 
design another file, you should issue a CLEAR ALL command to restore 
the attribute values in the design buffer to their defaults. 


Saving the file design is useful when you would prefer not to create 
the empty data file, but to store the file design for later use 
instead. You may need to interrupt your design session, or may want 
to fine tune your design at a another time. Saving the file design 
allows you to resume your session later. 
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For example, to save your file design in a file called INFILE.DES, 
type: 


DES: SAVE INFILE 
DES: 


This command stores the file design in the file INFILE.DES. Because 
the default file type is .DES, you can omit the file type from the 
command line. 


When you want to create the empty data file or resume the design 
session, you use the GET command to load the file design stored in 
INFILE.DES into the design buffer. You can then resume your design 
session or create the empty data file. 


The description file is also a useful reference tool. Because it is 
an ASCII sequential file, the attributes of a file can be displayed or 
printed. If the attributes of the file have changed over time, the 
description file provides a record of those changes. In addition, if 
the data file is lost or destroyed, the description file can be used 
to create an exact copy of the file (without the original data 
records). 


2.5 CREATING AN EMPTY DATA FILE 


You can use the CREATE command (Section 2.2.2) to create an empty data 
file, based on the attribute values in the design buffer. The empty 
data file is capable of containing records for use by your programs. 


If you are designing an indexed file but have defined no areas, you 
will be asked, when you issue the CREATE command, whether RMSDES is to 
define areas by default. If you respond YES or press RETURN (YES is 
the default), RMSDES will define areas based on the number of keys you 
specified in the key section. 
If, atter you creaté a file, you want to desigi 
should issue a CLEAR ALL command to restore t 
the design buffer to their defaults. 


fiie, you 
te values in 


a 
(0) 
© 
cr ot 
ro 
th oer 
te 
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Note that if you define areas and/or keys for an indexed file, they 
must be numbered sequentially starting with 0 (0, 1, 2,...) when you 
issue the CREATE command (see Section 2.2.2). 


As described in Section 2.1.1, an empty data file can also be created 
from an existing description or data file. The new data file will 
have the attributes of the existing external file. This method of 
creating a file is the equivalent of issuing a GET command to set the 
attributes in the design buffer to match those of an external file, 
and then issuing a CREATE command to create an empty data file with 
those attributes. See Section 2.3.2 for more information on using 
external files. 


The following examples show how to create an empty data file: 


DES: CREATE 
DES: 


specified in the design buffer. 


This command creates an empty data file with the file name and = type 
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DES: CREATE NEWFIL 
DES: 


This command creates an empty data file with the name specified in the 
command line, NEWFIL.DAT. Specifying a file name and type in the 
command string is useful when you want to create many different data 
files with the same attributes. 


DES INFILE 


This command is issued from your system prompt. It creates an empty 
data file based on the file design specified in the description file, 
INFILE.DES. The empty data file is given the file name and type 
specified in the description file. 


2.6 SECTIONS AND ATTRIBUTES 
The RMSDES design buffer is divided into five sections: 


e System section contains attributes that define the operating 
system on which you are using RMSDES and the operating system 
on which the file be will be used. 


e File section contains attributes that define the file's 
characteristics, such as name, organization, owner. 


@ Record section contains attributes that define the 
characteristics of the records within the file, such as 
format, size, carriage control. 


e Key section contains attributes that define the 
characteristics of keys and key segments in indexed files, 
such as name and data type for keys, and position and length 
for key segments. 


e Area section contains attributes that define the 
characteristics of areas in indexed files, such as position, 
allocation, contiguity. 


Sections 2.6.1 through 2.6.5 describe the design buffer sections and 
attributes. For each attribute, the attribute keyword and variable 
are given. 


The description of each attribute gives the attribute's function, the 
default if you do not supply a value for the variable, whether the 
attribute is informational, and whether the attribute is conditional. 


Informational attributes are those required by RMSDES; they are not 
RMS-11 file attributes. Some informational attributes, such as 
source, are saved in the description file; others, such as file 
placement, are only used by RMSDES to determine conditional prompting 
and are not saved in the description file. 


Conditional attributes are those for which you are prompted only if 
you have given a particular response to some previous prompt. For 
example, you will be prompted for a control field size number only if 
you have specified variable with fixed control as the record format. 
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2.6.1 System Section 


In the system section, you define the target system, that is, the 
operating system on which the file you are designing will be used. 
The source system (the operating system on which you are using RMSDES) 
is automatically set for you in the design buffer. You are not 
prompted for this attribute. Both the target and source attributes 
are informational attributes. 


In addition, if you issue a SET ALL command, you will be prompted for 
FILE PLACEMENT after the TARGET prompt, as follows: 


DES: SET ALL 
Starting SYSTEM section 
Target: SE, 
File Placement: 


In response to the FILE PLACEMENT prompt, type either YES or NO to 
indicate whether you will specify POSITION in the area section (see 
Section 2.6.5): 


e YES -- indicates that you will specify POSITION in the area 
section. You will not be prompted for allocation, extension, 
and bucket size in the file section; rather, you will be 


prompted for this information in the area section (area 0 is 
automatically defined for sequential and relative files). 


@ NO -- indicates that you will not specify POSITION in the area 
section. You will be prompted for allocation, extension, and 
bucket size in the file section. 


The default is NO. FILE PLACEMENT is an informational attribute used 
to determine conditional prompting; it is not saved in the 
description file. 


TARGET argument 


Specifies the operating system on which the data file will be 
created. TARGET is an informational attribute and is saved in 
the description file. 


For argument, type one of the following: 

@® RSX 

e RSTS 

The default is the system on which the file is being designed. 


Specifying a particular operating system does not necessarily 
limit the use of the file to that system. As long as your 
description or empty data file is not system specific, the file 
can be processed on other operating systems. However, if your 
description file or empty data file is system specific, the file 
may not be usable on another operating system. 


SOURCE 


This attribute is not user set; RMSDES automatically sets this 
attribute to the operating system you are using to design the 
file. Source is an informational attribute and is saved in the 
description file. 
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2.6.2 File Section 
NAME string 


Specifies the name of the file. For string, type ae file 
specification. 


If you do not specify a file in response to the NAME prompt and 
also do not specify a file name and type when you issue the 
CREATE command (see Section 2.2.2), the file will be created as 
FILE.DAT. 

ORGANIZATION argument 
Specifies the organization of the file. 


For argument, type one of the following: 


e SEQUENTIAL -- specifies a sequential file. You can store 
sequential files on disk or magnetic tape. 


e RELATIVE -- specifies a relative file. You can store relative 
files only on disk. 
@e INDEXED -~ specifies an indexed file. You can store indexed 


files only on disk. 


The default is SEQUENTIAL. 


CLUSTER SIZE number 


Specifies the number of blocks in a cluster for this file. You 
are prompted for this attribute only if you have specified the 
target system as RSTS/E. 


For number, type a value from 0 to 256 or from -l to -256 
indicating the cluster size value in blocks. See the RSTS/E 
System User's Guide for more information on specifying cluster 
size. 


The default is 0 blocks which indicates that the pack cluster 
size of the disk the file will be created on will be used. 


ALLOCATION number 


Specifies the initial size of the file in blocks. You will not 
be prompted for this attribute if you responded YES to the FILE 
PLACEMENT prompt (see Section 2.6.1). 


For number, type a decimal value indicating the allocation 
quantity in blocks. The minimum allocation you can specify is 0 
blocks; the maximum depends on the amount of available space on 
the disk or magnetic tape. 


If you are allowing RMSDES to define areas for an indexed file by 
default, RMSDES will automatically calculate an allocation value 
for each area it defines. However, if you choose to define areas 
explicitly and specify an allocation value for each area, accept 
the default for allocation in this section, and set the 
allocation attribute in each area section (see Section 2.6.5). 


The default is 0 blocks. 
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EXTENSION number 0 © 2 a aeaai aan a a 


Specifies the number of blocks that should be added to the file 
each time it is extended. You will not be prompted for this 
attribute if you responded YES to the FILE PLACEMENT prompt (see 
Section 2.6.1). 


For number, type a decimal value indicating the extension 
quantity in blocks. This quantity should be a multiple of the 
file bucket size value. 


When RMS-11 extends a file on RSX-11M/M-PLUS systems, it requests 
the number of blocks you have specified from the operating 
system. 


When RMS-11 extends a file on RSTS/E systems, it requests’ the 
number of blocks you have specified from the operating system. 
Then, it extends the file to the next full cluster larger than 
the request. 


If you are allowing RMSDES to define areas for an indexed file by 
default, RMSDES will automatically calculate an extension value 
for each area it defines. However, if you choose to define areas 
explicitly and specify an extension value for each area, accept 
the default for extension in this section and set the extension 
attribute in each area section (see Section 2.6.5). 


The default is 0 blocks. 


BUCKET SIZE number 


Specifies the number of blocks in a bucket for the file. This 
number determines the number of blocks read into memory during 
each file access operation, and therefore affects processing 
speed and the amount of memory a program accessing this file 
requires. You will not be prompted for this attribute if you 
responded YES to the FILE PLACEMENT prompt (see Section 2.6.1) or 
if you specified sequential as the file organization. 


If your target system is RSX-1IM/M-PLUS, for number, type a 
decimal value from 0 to 32, indicating the bucket size in blocks. 
The minimum value permitted is the number of blocks that can 
contain one record; the maximum is 32 blocks. 


If your target system is RSTS/E, for number, type a decimal value 
from 0 to 15, indicating the bucket size in blocks. The minimum 
value permitted is the number of blocks that can contain one 
record; the maximum is 15 blocks. 


In choosing a bucket size for RSTS/E files, you should consider 
the file cluster size. Because file cluster size governs file 
extension quantities and the way the RSTS/E file processor 
handles disk read operations, you can sometimes improve 
performance by aligning buckets with clusters. (See the RSTS/E 
Programming Manual.) 


If you are allowing RMSDES to define areas for an indexed file by 
default, RMSDES will automatically calculate an allocation value 
for each area it defines. However, if you choose to define areas 
explicitly and specify a bucket size vaiue for each area, you 
should accept the default for bucket size in this section and set 
the bucket size attribute in each area section (see Section 
23009) ° 


The default is 1 block. 
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PROTECTION string 


Specifies the type of access different categories of users can 
have to the file. 


RSX-LLM/M-PLOS. If your target system is RSX-1L1IM/M-PLUS, the 
protection code is expressed as a string of characters that 
defines the legal categories of users. The categories of users 
are system, owner, group, and world. 


For each category of user, you specify one or more of the letters 
representing the access types: RWED (representing Read, Write, 
Extend, and Delete). 


The user categories can be specified in any order in the 
following format: 


(GROUP: RWED , OWNER: RWED ,WORLD: RWED, SYSTEM: RWED) 


To deny access to a user category, simply omit the letter 
representing the access type: 


(GROUP: RWE, OWNER: RWED ,WORLD: , SYSTEM: RWED) 


The users in the group are denied access to delete the file. 
World users are denied all access. (For more information on 
protection, see the RSX-11M/M-PLUS MCR Operations Manual and the 
RSX-11M-PLUS Command Language Manual.) 


You can set individual protection fields. For example: 
DES: SET FILE PROTECTION (GROUP: RW) 


The users in the group can read and write the file; all other 
user categories have the default access. 


You can also set one protection field at one time and set another 
later. For example, suppose you had previously set group 
protection as above and now set world protection as follows: 


DES: SET FILE PROTECTION (WORLD: R) 


The previously set group protection (RW) would remain set, world 
users would have read access, and all other users would have the 
default access. 


If you use the SHOW command to display protection, only the 
fields that you explicitly set will be displayed. For example, 
suppose you made the settings in the above examples and then 
issued the SHOW command to verify the settings: 


DES: SHOW FILE PROTECTION 
PROTECTION ( GROUP:RW , WORLD:R ) ( Explicit ) 


The CLEAR command restores alli fields to their default values. 
You cannot clear an individual field. You can, however, use the 
SET command to reset a field to a new explicit setting. 


If you use the GET command and specify an external file, RMSDES 
will set the protection to correspond to the setting in the file. 
If the external file is a data file and protection is set to the 
system default (the default for this attribute), the protection 
will be displayed, if you issue a SHOW command, as if it had been 
explicitly set. However, if the external file is a description 
file and protection is set to the system default, the protection 
will not be displayed if you issue a SHOW command. 
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RSTS/E systems. If your target system is RSTS/E, the protection 
code is expressed as a decimal number ranging from 0 to 255. See 
the RSTS/E System User's Guide for more information on 
calculating protection numbers. 


The default is the target system default. 


OWNER string 
Specifies the owner of the file. 


If your target system is RSX-11M/M-PLUS, you will be prompted for 
file owner. For string, type the User Identification Code (UIC) 
of the user who will own the file. 


The default is the UIC of the person using RMSDES. 


If your target system is RSTS/E, you will not be prompted for 
this attribute. 


MAGTAPE BLOCK SIZE number 


Specifies the number of bytes in each magnetic tape block. This 
attribute applies to magnetic tape files only. You will be 
prompted for this attribute only if you specified sequential as 
the file organization. 


For number, type a decimal value from 18 through 8192. 


The default is 512 bytes. 


REWIND MAGTAPE logical 


Specifies that the magnetic tape is to be rewound, and that the 
file is to be stored at the beginning of the tape. This 
attribute applies to magnetic tape files only. You will be 
prompted for this attribute only if you specified sequential as 
the file organization. 


For logical, type YES or NO: 
® YES -- specifies that the tape will be rewound. 
e NO -- specifies that the tape will not be rewound. 


The default is NO. 


MAX RECORD NUMBER number 


Specifies the maximum number of records that a relative file will 
contain. If you are designing a sequential or indexed file, you 
will also be prompted for this value; RMSDES will use the number 
you supply for information if you allow RMSDES to define areas by 
default (area 0 is automatically defined for sequential and 
relative files; see the FILE PLACEMENT attribute, Section 
2.6.1). 


If you allow RMSDES to define areas by default, you must 
explicitly set this attribute. 
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RMS-11 checks the maximum record number whenever a record access 
operation is requested for this file. If the relative record 
number specified for the access operation exceeds the maximum 
record number, RMS-11 will issue an error message. 


For number, type a decimal value indicating the maximum record 
number value. 


Accepting the default value allows the file to contain as many 
records as physically possible. 


The default is 0 records. 


CONTIGUOUS logical 


Specifies whether the disk space for this file will be allocated 
in contiguous blocks. File contiguity minimizes head movement 
when the file is being accessed. 


For logical, type YES or NO: 
e YES -- specifies that the file will be contiguous. 
e NO -- specifies that the file will not be contiguous. 


If you are defining areas explicitly, you should take the default 
for this attribute and specify contiguity in the area section 
(see Section 2.6.5). 


If you are defining areas for an indexed file and your target 
system is RSX-11M/M-PLUS, it is possible that the areas will not 
be contiguous. However, the records within each area will be 
contiguous if you accept the default (NO) for this attribute and 
set the contiguous attribute in the area section to YES. (See 
Section 2.6.5.) 


If your target system is RSTS/E and you declare the file to be 
contiguous, it will not be able to be extended unless you 
specifically make it non-contiguous. To achieve both file 
contiguity and extension, find contiguous space on your disk and 
specify the logical block number where you want the file to 
begin. 


The default is NO. 


SUPERSEDE logical 


Specifies whether you want the present version of the file to 
supersede an earlier version with an identical file name, type, 
and (if your target system is RSX-11M/M-PLUS) version. 


type YES or NO: 


@e YES -- specifies that this file will supersede an existing 
file. 
e NO -- specifies that if RMSDES encounters a file with an 


identical file specification, it will not create the file. 


The default is NO. 
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SIZE number 
Specifies the record size in bytes. 


For number, type a decimal value from 1 to 16,384 indicating the 
record size, If you are allowing RMSDES to define areas for an 
indexed file by default, you must explicitly set this attribute. 


If you accept the default, RMS-1l will accept records of any 
length up to 16K bytes into the file. Note, however, that the 
actual record length accepted by RMS-1l may depend on other 
factors, such as file organization, record format, target 
operating system. If your target system is RSX-l11M/M-PLUS, see 
the RSX-11M/M-PLUS RMS-11 User's Guide; if your target system is 
RSTS/E, see the RSTS/E RMS-11 User's Guide. 


The meaning of the record size information depends on the record 
format: 


e For variable-length and stream records, the record size you 
specify is a maximum length, the size of the largest possible 
record for that file. RMS-1ll rejects any write operation 
using a record size greater than the maximum. 


e For fixed-length records, the record size you specify is the 
same length for every record in the file.  RMS-11l rejects any 
write operation that specifies a record of the wrong size. 


e@e For variable-with-fixed-control records, there are two size 
specifications: 


- Maximum length of the variable area 
- Length of the fixed control area 


Specifying the size attribute sets the maximum length of only 
the variahle area of your record. To specify the length of 


the fixed control area, set the CONTROL FIELD SIZE attribute 
(described below). 


RMS-11 treats the specifications for both the variable area 
and the fixed-control area the same way it treats the sizes 
for variable-length records and fixed-length records, 
respectively. 


The default is 0 bytes. 


FORMAT argument 
Specifies the record format for the file. 
For argument, type one of the following: 


e VARIABLE -- specifies that records in the file will have 
differing, or variable, lengths. 


e STREAM -- specifies that the records in the file will have no 
specific format, but will be delimited only by record 
terminator characters. The stream format is permitted for 
sequential disk files only. 
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@ FIXED -- specifies that the records in the file have the same, 
fixed length. 


e VFC -- specifies that each record in the file has a control 
area with a fixed length and a data area of no standard 
length. 


The default is VARIABLE. 


CONTROL FIELD SIZE number 
Specifies the size in bytes of the fixed control area of each 
record in the file. You will be prompted for this attribute only 
if you specified the record format as variable with fixed 
control. 
For number, type a decimal value from 1 through 255. 


The default control field size is 2 bytes. 


BLOCK SPAN logical 
Specifies whether records can cross block boundaries. You will 
be prompted for this attribute only if you specified the file 
organization as sequential. 


Spanning block boundaries maximizes use of space on a disk. 
Otherwise, the size of a record is limited to 1 block. 


For logical, type YES or NO: 
e YES -- specifies that records can cross disk block boundaries. 


e NO -- specifies that records cannot’ cross disk block 
boundaries. 


The default is YES. 


CARRIAGE CONTROL argument 


Specifies how your records are written to a unit record device 
(terminal or printer). 


For argument, type one of the following: 

e CARRIAGE RETURN -- specifies that each record will be preceded 
by a line feed character and followed by a carriage return 
character when it is written to a unit record device. 

@ FORTRAN -- specifies that the first byte of each record is’ to 
be interpreted as a FORTRAN forms-control character when the 
record is written to a unit record device. 


@ NONE -- specifies no carriage control. 


The default is CARRIAGE RETURN. 
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2.6.4 Key Section. 


The key section allows you to define keys for an indexed file. You 
can define the following key characteristics: 


@e Number of keys 
@ Position, size, type, and name of each key 
e Whether records can have duplicate key values 


e Whether alternate key values can change during update 
operations 


e Whether keys are segmented 
@e Null key value for duplicate keys 
e Fill factors for keys 


If you are designing an indexed file, RMSDES will prompt you for the 
number of keys that the file will contain. If you issue the SET ALL 
command, RMSDES will prompt you for the number of keys when you reach 
the key section. If you issue the SET KEY ALL command, RMSDES will 
prompt you immediately for the number of keys, as follows: 


Number of keys? 


There is no default response to this prompt. Type a decimal number to 
specify the number of keys you are defining for the area, and press 
RETURN. You can specify up to 255 keys per area; RMSDES will number 
them from 0 to 254. You will be prompted for all of the key 
attributes for every key you are defining. Note that keys must be 
numbered sequentially starting with 0 (0, 1, 2,...) when you issue the 
CREATE command (see Section 2.2.2). 


If you are setting only one key, you must specify the key number to be 


prompted for key attributes. For example, to set a primary key, you 
wanld use the followinc GET 


mammaanas 
we ev Yeu say nw ad Ne SALLELLICA LEM 
SET KEY 0 ALL 
If you are allowing RMSDES to define areas by default, RMSDES will 
define the areas based on the number of keys you specify in this 
section (see Section 2.6.5 and Appendix B for more information on how 
RMSDES defines areas). 
NAME string 
Specifies the name of the key. 
For string, type a key name of up to 32 ASCII characters. 
Accepting the default specifies that no name is assigned to the 
key. 
TYPE argument 


Specifies the data type of the key. 
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For argument, type one of the following: 


e STRING -- specifies that the key value is a string of 
alphanumeric characters. 


e BIN2 -- specifies that the key value is a 2-byte unsigned 
integer. 

e BIN4 -- specifies that the key value is a 4-byte unsigned 
integer. 

s INT2 -- specifies that the key value is a 2-byte signed 
integer. 

e INT4 -- specifies that the key value is a 4-byte signed 
integer. 

e DECIMAL -- specifies that the key value is a packed decimal 
number. 


The default is STRING. 


Specifies whether the file will contain some records that cannot 
be accessed by this key. These records will be assigned a null 
value for this key. The null value is specified in the 
NULL VALUE attribute, described below. The null key attribute 
applies only to alternate keys. 


For logical, type YES or NO: 


e YES -- specifies that this alternate key will contain a null 
key value. 


e NO -- specifies that this alternate key will not contain a 
null key value. 


The default is NO. 


NULL VALUE argument 


This attribute applies to alternate keys only. It specifies the 
null value for this key; that is, the file will contain some 
records that cannot be defined by the key. You will be prompted 
for this attribute only if you have specified YES for the 
NULL KEY attribute, described above. 


For argument, you can type: 
e An ASCII character -- to indicate a character null value, type 
a character or a space, enclosed in apostrophes. For example, 


'X' indicates that the character X is a null value. 


e A decimal number -- to indicate a numeric null value, type a 
number from 0 to 255. 


The default is a space (' '). 
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DUPLICATES Ltogical OS cee se en, pases ; = 


Specifies whether the file can contain more than one record with 
the same value for this key. 


For logical, type YES or NO: 


e YES -- specifies that duplicate key values will be allowed. 
If you type YES for alternate keys and are allowing RMSDES to 
define areas by default, you will be prompted for the average 
number of duplicates per alternate key; RMSDES uses this 
value to calculate area allocation (see Section 2.6.5). 


e NO -- specifies that duplicate key values will not be 
allowed. 


The default for alternate keys is YES; for primary keys, NO. 


CHANGES logical 


Specifies whether an alternate key can change values during an 
update operation; that is, whether the record can be read with 
one value for the key and rewritten with another value for the 
same key. This attribute applies only to alternate keys. 


For logical, type YES or NO: 


e YES -- specifies that the value of this alternate key can be 
changed. 

e NO -- specifies that the value of this alternate key cannot be 
changed. 


The default is YES. 


DATA FILL number 


Specifies the percentage of the data level bucket that should be 
filled when the file is initially loaded. 


For number, type a decimal value from 50 to 100, indicating the 
percentage to which each data bucket should be filled. 


The default is 100 percent. 


DATA AREA number 


Specifies the area that will contain the data records for _ the 
primary key and pointers to the data records for an alternate 
key. 


For number, type a decimal value indicating the area. 


If you are allowing RMSDES to define areas by default, you must 
accept the default for this attribute. 


Note that if you specify a data area, you also must specify the 
allocation, extension, bucket size, and contiguous attributes of 
this area in the area section (see Section 2.6.5). Otherwise, an 
error message will be issued and the area will not be created. 
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INDEX FILL number 


Specifies the percentage of the index level bucket that should he 
filled when the file is initially loaded. 


For number, type a decimal value from 50 to 100, indicating the 
percentage to which each index level bucket should be fiiled. 
Because the index level buckets contain only pointers rather than 
actual records, you may want to specify a different fill factor 
for the index level buckets than for the data level buckets. 


The default is 100 percent. 


LEVEL1 INDEX AREA number 


Specifies the area that will contain the lowest-level index area 
for this key. 


For number, type a decimal value indicating the area. 


If you are allowing RMSDES to define areas by default, you must 
accept the default for this attribute. 


Note that if you specify a level-l index area, you must make sure 
that the area is defined by setting the allocation, extension, 
bucket size, and contiguous attributes for the area in the area 
section (see Section 2.6.5). If you have issued a SET ALL 
command, you will be prompted for these attributes automatically. 
Otherwise, you can issue a SET AREA command to be prompted for 
them. You can take the defaults for any of the attributes. 
However, if the area is not defined, an error message will be 
issued and the area will not be created when you issue a CREATE 
command. 


The default is area 0. 


INDEX AREA number 


Specifies the area that will contain the upper levels of the 
index for this key. 


For number, type a decimal value indicating the area. 


If you are allowing RMSDES to define areas by default, you must 
accept the default for this attribute. 


Note that if you specify an index area, you must make sure that 
the area is defined by setting the allocation, extension, bucket 
size, and contiguous attributes for the area in the area section 
(see Section 2.6.5). If you have issued a SET ALL command, you 
will be prompted for these attributes automatically. Otherwise, 
you can issue a SET AREA command to be prompted for them. You 
can take the defaults for any of the attributes. However, if the 
area is not defined, an error message will be issued and the area 
will not be created when you issue a CREATE command. 


The default is area 0. 


2.6.4.1 Key Segments - This part of the key section allows you to 
define segments for keys. Note that only string keys can have more 
than one segment. Nonstring keys, by definition, have one segment 
(segment 0). 


RMS-11 FILE DESIGN OTILITY: RMSDES 


“If you have specified a string key type, and are defining keys 
interactively, you will be prompted for the number of segments you are 
defining for your key, as follows: 

Number of segments? 


This prompt occurs after the DUPLICATES prompt. Type a decimal number 
to specify the number of segments you want to define for that key, and 
press RETURN. You can specify up to eight segments, numbered from 0 
to 7. 


You will be prompted for the SEGn POSITION and SEGn LENGTH attributes, 
described below. You must define all segments you have specified. 
For example, if you have specified that a key will have three 
segments, you will be prompted for the position and length of all 
three segments. 


SEGn_ POSITION number 


Specifies the position of the first byte of the segment within 
the record. This attribute applies to string keys only. 


For number, type a decimal value indicating the position of the 
first byte of the segment within the record. Bytes within a 
record are numbered sequentially starting with 0. 


The default is byte 0. 


SEGn LENGTH number 


Specifies the length, in bytes, of the segment within the record. 
This attribute applies to string keys only. 


For number, type a decimal value from 0 to 255 indicating the 
length of the segment within the record. 


Note that the maximum length of a key segment depends on _ the 
record size you have specified. 


The default is 0 bytes. 


SEGO POSITION number 
Specifies the position of the first byte of of a nonstring key 
within the record. Nonstring keys cannot have more than one 
segment; however, this attribute allows you to position position 
a single-segment nonstring key (segment 0) within the record. 


For number, type a decimal value indicating the position of the 
first byte of segment 0 within the record. 


The default is byte 0. 


2.6.5 Area Section 
he aréa section allows you to define areas for an indexed file. 


Areas are portions of an indexed file that are treated independently 
for position, initial allocation, extension, bucket size, and 
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contiguity. Defining areas allows you to improve the performance of 
your file by dividing indexed files into Separate units for each index 
and for the data levels. 


Defining Areas Explicitly. To define areas explicitly, you first 
should accept the defaults for the contiguous, allocation, extension, 
and bucket size attributes in the file section. Note, however, that 
if you set these attributes in both the file and area sections, the 
values set in the area section will override the values set in the 
file section. 


Then, you must specify which area will contain the data records and 
which areas will contain the indexes of each key by setting the data 
area, level-1l index area, and index area attributes in the key section 
(see Section 2.6.4). 


Finally, you must set the attributes of each area by explicitly 
setting values in this section. 


If you issue a SET ALL command, RMSDES will prompt you when you’ reach 
the area section: 


Areas defaulted: 


Since you are defining areas explicitly, type NO. RMSDES will then 
prompt you: 


Number of areas: 


If you issue a SET AREA ALL command, RMSDES will prompt you 
immediately for the number of areas. Type a decimal number to specify 
the number of areas you are defining for the file. You can specify up 
to 255 areas; RMSDES will number them from 0 to 254. 


RMSDES will prompt you for each area attribute in every area you 
define. Note that areas must be numbered sequentially starting with 0 
(0, 1, 2,...) when you issue the CREATE command (see Section 2.2.2). 


If you define no areas but issue a CREATE command, the file will be 
created with a single area (the RMS-1l default); if you issue a SHOW 
ALL command, no area will be created. 


Defining Areas by Default. In most cases, letting RMSDES define 
areas by default is the best option. To do so, first you should 
accept the defaults for the allocation, extension, bucket size, and 
contiguous attributes in the file section (see Section 2.6.2), and 
explicitly set the size attribute in the record section (see Section 
2623) % 


If you issue a SET ALL command, RMSDES will prompt you when you’ reach 
the area section, as follows: 


Areas defaulted: 


Type YES or press RETURN (YES is the default) to indicate that you 
want RMSDES to define the areas. 


You will also be prompted for bucket size: 
Bucket Size (2): 
Type a decimal number indicating the bucket size in blocks. The 


minimum value that you should enter is the number of blocks that can 
contain one record. If your target system is RSX-11M/M-PLUS, the 
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maximum is 32 blocks. If your target system is RSTS/E, the maximum is 
15 blocks. The default is 2 blocks for all target systems. (See also 
the description of the BUCKET SIZE attribute below.) 


These prompts will also appear if you issue a CREATE command but have 
defined no areas. 


Based on your responses to the prompts, RMSDES will begin to define 
the areas. First, it will construct the primary index and issue an 
informational message: 


The primary index has a depth of n 
where n is the number of index levels, excluding the data level (0). 


If you have specified multiple keys, and answered YES to the 
DUPLICATES prompt in the key section (see Section 2.6.4), RMSDES will 
print the next alternate key number and prompt: 


Average number of duplicates? 


There is no default response to this prompt; type a decimal number to 
indicate the average number number of duplicates per record for this 
key. RMSDES will use the value you enter in its area calculations. 


After you respond to the prompt, RMSDES will construct the alternate 
index and issue an informational message: 


The index for alternate key x 
has a depth of n 


where x is the alternate key number and n is the number of index 
levels, excluding the data level (0). 


The prompt and informational message will be repeated for each 
alternate key. 


When you issue a CREATE command, RMSDES will define areas based on 
your responses to the prompts and on the number of keys you specified 
in the key section. See also Appendix B. 


Note that you should issue the CLEAR command to clear any area 
attributes you may have previously set. If any area attributes are 
set when you issue a CREATE command, you will not receive the "Areas 
defaulted" prompt; RMSDES will assume that you want to set areas 
explicitly and will prompt you for the area settings. 


ALLOCATION number 


Specifies the initial size of the area in blocks. 


For number, type a decimal value indicating the allocation 
quantity in blocks. 


If you specify an allocation value for this area, you should also 
accept the default for allocation in the file section (see 
Section 2.6.2). If the allocation attribute is set in both the 
file and the area sections, the value in the area section will 
override the value in the file section. 


If you are allowing RMSDES to define areas by default, RMSDES 
will automatically calculate this attribute value. 


The default is 0 blocks. 
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EXTENSION number 


Specifies the number of blocks that will be added to the area 
each time it is extended. 

For number, type a decimal value indi ing the extension 
quantity in blocks. This extension quantity should be a multiple 
of the area bucket size value. 


If you are allowing RMSDES to define areas by default, RMSDES 
will automatically calculate this attribute value. 


When RMS-1]l extends an area on RSX-11M/M-PLUS systems, it 
requests the number of blocks you have specified from the 
operating system. 


When RMS-11 extends an area on RSTS/E systems, it requests’ the 
number of blocks you have specified from the operating system. 
Then, it extends the area to the next full cluster larger than 
the request. 


If the extension attribute is set in both the file and the area 
sections, the value in the area section will override the value 
in the file section. 


The default is 0 blocks. 


BUCKET SIZE number 


Specifies the number of blocks in a bucket for the area. You are 
prompted for this attribute only if you specified relative or 
indexed file organization in the file section (see Section 
26651): 


The bucket size number determines the number of blocks read into 
memory during each area access operation, and therefore affects 
processing speed and the amount of memory a program accessing 
this area requires. 


If your target system is RSX-11M/M-PLUS, for number, type a 
decimal value from 1 to 32 indicating the bucket size in blocks. 
The minimum value that you should enter is the number of blocks 
that can contain one record; the maximum is 32 blocks. 


If your target system is RSTS/E, for number, type a decimal value 
from 1 to 15 indicating the bucket size in blocks. The minimum 
value that you should enter is the number of blocks that contain 
one record; the maximum is 15 blocks. 


In choosing a bucket size for RSTS/E files, you should consider 
the file cluster size. Because file cluster size governs file 
extension quantities and the way the RSTS/E file processor 


handles disk read operations, you can sometimes improve 
performance by aligning buckets with clusters. 


If the bucket size attribute is set in both the file section and 
area section, the value in the area section will override the 
value in the file section. 


If you are allowing RMSDES to define areas by default, RMSDES 
will prompt you for this attribute value; note that, in this 
case, the default is 2 blocks (see the discussion at the 
beginning of this section titled Defining Areas by Default). 
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The default is 0 blocks if you are explicitly defining areas; 2 
blocks if you allow RMSDES to define areas by default. 


CONTIGUOUS logical 


Specifies whether the disk space for this area will be allocated 
in contiguous'7 blocks. Area contiguity minimizes head movement 
when the area is being accessed. 


For logical, type YES or NO: 


e YES -- specifies that the records within the area will be 
contiguous. 


e NO -- specifies that the records within the area will not be 
contiguous. 


If you declare area contiguity, the records within each area will 
be contiguous; however, the areas themselves may not _ be 
contiguous. 


If you have specified area contiguity, you should also have 
accepted the default for contiguity (NO) in the file section (see 
Section 2.6.2). If the contiguous attribute is set in both the 
file and the area sections, the entire file will be contiguous. 


The default is NO. 


If indexed areas are present, and (a) no placement is specified, 
(b) contiguous areas are not desired, and (c) the file was 
requested contiguous, the area sizes will be summed and the file 
created as one contiguous area. The areas will be allocated from 
that. 


POSITION argument 
Specifies file placement, that is, where the area will be 
positioned on disk. This attribute applies to disk files only. 
You will be prompted for this attribute only if you responded YES 
to the FILE PLACEMENT prompt in the system section (see Section 
Zeek) % 


For argument, type one of the following: 


e NONE -- specifies that the area is to be positioned wherever 
there is space on the disk. 


e VIRTUAL number -- specifies that the area will begin near’ the 
designated virtual block. 


For number, type a decimal number indicating the virtual block 
number (VBN). 


e LOGICAL number -- specifies that the area is to begin at the 
designated logical block. 


For number, type a decimal number indicating the logical block 


number (LBN), 
nmomper (Lon) . 


The default is NONE. 
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EXACT POSITIONING logical 


Specifies whether the area will be positioned beginning exactly 
at the logical block number (LBN) specified for the POSITION 
attribute. You will be prompted for this attribute only if you 
have specified an LBN for POSITION. 


For logical, type YES or NO: 


e YES -- specifies that the area must begin at the specified 
LBN. If the area cannot be positioned there, RMSDES will not 
create the file. 


e NO --~ specifies that if the area cannot be positioned exactly 
at the specified LBN, RMSDES will create the file, positioning 
it as close as possible to the specified LBN. 


The default is NO. 


2.7  RMSDES EXAMPLES 


DES: SET ALL 
Starting SYSTEM section 
Target: RSX 
File Placement: 
Starting FILE section 
Name: PAYROL.DAT 
Organization (Seq): INDEXED 
Allocation (0): 3 
Extension (0): 
Bucket Size (1): 
Protection: 
Owner: 
Max Record Number (0): 
Contiguous (No): 
Supersede (No): YES 
Starting RECORD section 
Size (0): 
Format (Var): VARIABLE 
Carriage Control (CR): CARRIAGE 
Number of keys: 2 
Starting Key 0 
Name: 
Type (String): STRING 
Duplicates (Yes if alternate): YES 
Number of Segments: 1 
Seg0 Position: 0 
Seg0 Length: 12 
Data Fill (100): 
Data Area (0): 
Index Fill (160): 
Levell Index Area (0): 
Index Area (0): 
Starting Key 1 
Name: 
Type (String): STRING 
Null Key (No): NO 
Duplicates (Yes if alternate): YES 
Changes (Yes): YES 
Number of Segments: 1 
Seg0 Position: 0 
Seg0 Length: 17 


RMS-11 FILE DESIGN UTILITY: RMSDES 


Data Fill (100): 
Data Area (0): 
Index Fill (100): 
Levell Index Area (0): 
Index Area (0): 
Areas defaulted: NO 
Number of areas: 1 
Starting Area 0 
Allocation (0): 3 
Extension (0): 
Bucket Size (1): 
Contiguous (No): 
Position (None): 
DES: CREATE 
DES: SAVE PAYROL.DES 
DES: “Z 


The SET ALL command is used in this example to create an indexed file, 
PAYROL.DAT, which has an initial allocation of 3 blocks, 
variable-length records with carriage-control, and two string keys. 
One area is defined. 


The contents of the design buffer are also saved in a file called 
PAYROL.DES. 


DES: SET FILE NAME STAT.DAT 
DES: SHOW ALL 


SYSTEM 
Target RSX 
Source RSX 

FILE 
Name STAT.DAT (Explicit) 
Organization SEQUENTIAL 
Allocation 0 
Extension 0 
Protection 
Owner {70,5] 
Magtape Blocksize 512 
Rewind Magtape NO 
Max Record Number 0 
Contiguous | NO 
Supersede NO 

RECORD 
Size 0 
Format VARIABLE 
Control Field Size 0 
Block Span — YES 
Carriage Control CARRIAGE RETURN 


DES: CREATE 


This example illustrates the default values which are initialized in 
the design buffer. The file name is the only value which is 
explicitly set; the remaining values are the default values. 


The sequential file, STAT.DAT, is created in the default account. The 
owner of the file is the default account, and the records are variable 
length with the carriage-control attribute. The file is not 


contiguous and does not supersede any existing file with the same 
name. 
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DES: CLEAR ALL 
DES: SET FILE NAME EMPLY.DAT 


DES: SET FILE ORGANIZATION RELATIVE 
DES: SET RECORD FORMAT 
VALUE: ? 


Format argument 
Specifies the record format for the file. 


For argument, type one of the following: 


e VARIABLE -- specifies that records in the file will have 
differing, or variable, lengths. 

e STREAM -- specifies that the records in the file will have no 
specific format, but will be delimited only by record 


terminator characters. The stream format is 


sequential disk files only. 


permitted for 


@ FIXED -- specifies that the records in the file have the same, 
fixed length. 


e VFC -- specifies that each record in the file has a_ control 
area with a fixed length and a data area of no standard 
length. 


The default is VARIABLE. 


VALUE: VFC 


DES: SET RECORD SIZE 80 
DES: SET FILE BUCKET 2 
DES: SHOW ALL 
SYSTEM 
Target RSX 
Source RSX 
FILE 
Name EMPLY.DAT (Explicit) 
Organization RELATIVE (Explicit) 
Allocation 0 
Extension 0 
Bucket Size 2 (Explicit) 
Protection 
Owner [70,5] 
Max Record Number 0 
Contiguous — No 
Supersede NO 
RECORD 
Size 80 (Explicit) 
Format VFC (Explicit) 


Control Field Size 
Carriage Control 
DES: SET FILE ALLOCATI 
DES: CREATE 


ON 


0 
CARRIAGE RETURN 
0 


This example illustrates the interactive nature of RMSDES. 


First, some design parameters are specified: file mame and file 
organization. When record format is specified, however, the help 
facility is invoked in order to choose the VFC record format. 
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Next, record size and file bucket size are specified. Then, the SHOW 
ALL command is used to display the entire contents of the design 
buffer. 


Finally, the CREATE command is used to create the EMPLY.DAT file. 


DES: CLEAR ALL 

DES: SET FILE ALL 

Starting FILE section 
Name: ACCNT.DAT 
Organization (Seq): INDEXED 
Allocation (0): 30 
Extension (0): 
Bucket Size (1): 3 
Protection: 
Owner: 
Max Record Number (0): ? 


Max Record Number number 


Specifies the maximum number of records that a relative file will 
contain. If you are designing a sequential or indexed file, 
you supply this as an informational value if you allow RMSDES- to 
define areas by default. (Area 0 is automatically defined for 
sequential and relative files.) 


If you allow RMSDES to define areas by default, you must 
explicitly set this attribute. 


RMS-11 checks the maximum record number whenever a record access 
operation is requested for this file. If the relative record 
number specified for the access operation exceeds the maximum 
record number, RMS-11 will issue an error message. 


For number, type a decimal value indicating the maximum record 
number value. 


Accepting the default value allows the file to contain as many 
records as physically possible. 


The default is 0 records. 


Max Record Number (0): 
Contiguous (No): 
Supersede (No): YES 
DES: SET RECORD ALL 
Starting RECORD section 
Size (0): 80 
Format (Var): FIXED 
Carriage Control (CR): NONE 
DES: SET KEY 0 ALL 
Starting Key 0 
Name: 
Type (String): STRING 
Duplicates (Yes if alternate): 
Number of Segments: 1 
Seg0 Position: 0 
Seg0 Length: 15 
Data Fill (100): 
Data Area (0): 
Index Fill (100): 
Levell Index Area (0): 


Index Area (0 
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Organization 
Allocation 
Extension 
Bucket Size 
Protection 
Owner 
Max Record Number 
Contiguous — 
Supersede 
RECORD 
Size 
Format 
Control Field Size 
Carriage Control 
KEY o 
Name 


Type 
Null Key 
Null Value 
Duplicates 
Changes 
SegO Position 
Seg0 Length 
Data Fill 
Data Area 
Index Fill 
Levell Index Area 
Index Area _ 
DES: CREATE 
Areas defaulted: ? 


RSX 
RSX 


ACCNT.DAT (Explicit) 
INDEXED (Explicit) 
30 (Explicit) 

0 

3 (Explicit) 


[70,5] 

0 

NO 

YES (Explicit) 


80 (Explicit) 
FIXED (Explicit) 
0 

NONE (Explicit) 


0 (Explicit) 
15 (Explicit) 


If you issue a SET ALL, a SET AREA ALL, or a 


indexed file and have 


not defined areas, 


you reach the area section: 


command on an 
RMSDES will prompt you when 


Areas defaulted: 


If you are defining areas explicitly, or do not want RMSDES to define 
areas for you, type NO. If you issued a SET ALL command, RMSDES will 
prompt you for the number of areas you wish to define. If you issued 
a CREATE command, the file will be created with the RMS-11 default 


area. If you issued a SHOW ALL command, no action will be taken. 


Type YES or press RETURN to indicate that you want RMSDES to define 
the areas. The areas will be defined based on the number of keys you 


specified in the key section. 


Areas defaulted: NO 
DES: QUIT 


In this example, the design is completed by specifying the file a 
"section" at a time. 


The SET FILE ALL command is used to define all file attributes and 
help facility is used to get more information on the MAX RECORD NUMBER 
attribute. The SET RECORD ALL and SET KEY 0 ALL commands complete the 
definition of the file, and the SHOW ALL command displays the contents 
of the design buffer. 
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The CREATE command is invoked to create the file; Since areas have 
not been defined, RMSDES queries about defaulting the area definition. 
In this case, the answer "NO" is given causing the file to be created 
with the RMS-11 default area. 


2.8 RMSDES MESSAGES 


This section documents the error messages returned by RMSDES. Each 
message is displayed in the format: 


?DES-F-xxx, message text 


?DES 
Identifies the message as an RMSDES message. 

F 
Severity code. A severity code of F is "fatal": the operation 
will not be performed. After the error message is displayed, the 
DES: prompt will reappear. Retry the operation. 

XXX 


Message code: an abbreviation of the message text. 
message text 

Indicates the reason that the error occurred. 
The RMSDES messages are listed below in alphabetical order by the 
message code. Each message is accompanied by an explanation of the 
error and recommended user action to correct the error. 


?DES-F-AMA, Ambiguous attribute specified 


Explanation: You entered an attribute keyword using an 
abbreviation that was not unique. 


User Action: Reenter the command using a valid abbreviation for 
the attribute keyword. 


?DES-F-AMC, Ambiguous command 


Explanation: You entered a command using an abbreviation that 
was not unique. 


User Action: Reenter the command using a valid abbreviation. 
?DES-F-AMS, Ambiguous section specified 


Explanation: You entered a section keyword using an 
abbreviation that was not unique. 
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RMS-11 FILE DESIGN UTILITY: RMSDES 


?DES-F-ANS, Area not defined 


Explanation: You specified an area that has not been defined. 
User Action: Reenter the command using the number of a defined 
area. Use the SHOW AREA ALL command to display the defined 
areas. 


?DES-F-AOR, Area number out of legal range 


Explanation: Areas are numbered from 1 through 255. You 
specified an area number outside of this range. 


User Action: Reenter the command specifying a valid area 
number. 
?DES-F-CSE, Syntax error 


Explanation: You entered a string in response to the Protection 
or the Owner attribute prompt using incorrect syntax. 


User Action: Reenter the string using correct syntax. 
Protection should be specified in the format: 


(group: RWED,owner:RWED,world:RWED,system: RWED) 


Owner should be specified as the UIC of the user who will own the 
file: 


[n,n] 


The value n is an octal number. 


?DES-F-IAN, Illegal area number 
Explanation: You entered an illegal value for an area number. 
User Action: Reenter the command specifying a positive number 
from 0 through 254. 

?DES-F-IBR, Illegal response given, must be YES or NO 


Explanation: You were prompted for an attribute value that 
requires a logical argument. 


User Action: Enter YES or NO. 


?DES-F-ICL, Incomplete command line within a command file 


Explanation: You specified an incomplete command line within an 
indirect command file. Execution of the command file will stop 
at that point. 


User Action: Correct the indirect command file so that’ the 
command line is complete and re-execute the job. 


RMS-11 FILE DESIGN UTILITY: RMSDES 


?DES-F-IFT, Illegal file type value specified 


Explanation: You issued a GET command or you used the DES 
filename[.typ] {kind] form of invocation and used an invalid 


specification for file kind. 


User Action: Reenter the command with a valid file kind 
specification: DES (the default) for description files created 
using RMSDES, or DAT for data files. 

?DES-F-IKV, Illegal key number 
Explanation: You specified an illegal value for a key number. 
User Action: Reenter the command specifying a positive number 
from 0 through 254. 

?DES-F-ILA, Illegal attribute specified 
Explanation: You specified an attribute keyword that is not a 
valid attribute. 
User Action: Reenter the command using a valid attribute 
keyword; make sure the keyword is spelled correctly. 

?DES-F-ILC, Illegal command 
Explanation: You entered an invalid command. 
User Action: Reenter the command using a valid command name; 
make sure the command is spelled correctly. 

?DES-F-ILN, Illegal response given, must be numeric 
Explanation: You entered a nonnumeric value in response to a 
prompt for number of keys, areas, or segments. 
User Action: Enter a valid numeric value in response to the 
prompt. The range for keys and areas is 1 through 255. The 
range for segments is 1 through 8. 

?DES-F-IPC, Illegal protection class 
Explanation: You specified an illegal category of user. 
User Action: Enter a valid user category: SYSTEM, OWNER, 
GROUP, or WORLD. 

?DES-F-IPO, Illegal protection option specified 
Explanation: You specified an illegal access type. 
User Action: Enter a valid access’ type: R, W, E, or OD 
(representing Read, Write, Extend, or Delete; on VAX/VMS 


systems, E represents Execute). 
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?DES-F-IRO, Illegal response, must be octal numeric 


Explanation: You used a non-octal number in the UIC you 
specified in response to the Owner attribute prompt. 


User Action: Enter a valid UIC. 


?DES-F-ISE, Illegal section specified 
Explanation: You specified an invalid section keyword. 


User Action: Reenter the command using a valid section keyword; 
make sure the keyword is spelled correctly. 


?DES-F-IVS, Illegal value specified 


Explanation: You entered an illegal value in response to an 
attribute prompt. 


User Action: Enter a legal value; see Section 2.6 for 

descriptions of the attributes and their legal values. 
?DES-F-KMA, Key missing corresponding area 

Explanation: You defined keys and assigned key levels to areas 

but did not define the areas. When you issued the CREATE 

command, RMSDES could not define the areas. 

User Action: Define the area(s) to correspond to your key 


definitions. 


?DES-F-KNS, Key has not been defined 


Explanation: You specified a key that has not been defined. 
User Action: Reenter the command specifying the number of a 
defined key. Use the SHOW KEY ALL command to display the defined 
keys. 


?DES-F-KOR, Key number out of legal range 


Explanation: Keys are numbered from 1 through 255. You 
specified a key outside of this range. 


User Action: Reenter the command specifying a valid key number. 


Explanation: You issued a CLEAR, HELP, SET, or SHOW command for 
an area but did not specify an area number. 


User Action: Reenter the command specifying a valid area 
number. 
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?DES-F-NKN, No key number given 
Explanation: You issued a CLEAR, HELP, SET, or SHOW command for 
a key but did not specify a key number. 


User Action: Reenter the command specifying a valid key number. 


?DES-F-NUS, Not a user settable attribute 


Explanation: You tried to set the Source attribute. This 
attribute is not user settable. 


User Action: None. RMSDES automatically notes the user's 
(source) system. 


?DES-F-VOR, Value out of legal range 


Explanation: You entered a value in response to an attribute 
prompt that was not in the legal range of values for that 
attribute. 

User Action: Enter a value within the legal range; see Section 


2.6 for descriptions of the attributes and their legal values. 


CHAPTER 3 
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The RMS-11 Indexed File Load Utility (RMSIFL) reads records from any 
type of RMS-11 file and loads them into an RMS-11 indexed file created 
to store them. In addition, you can use RMSIFL to reestablish areas 
of contiguity to indexed files (that is, to compress indexed files) 
and to convert ASCII stream files to RMS-11 indexed files. 


Unlike RMSCNV (see Chapter 4), RMSIFL does not use the standard RMS-11 
access methods to build the output file. Rather, RMSIFL exploits the 
basic structure of indexed files (see the RSX-11M/M-PLUS RMS-11 User's 
Guide) to quickly insert data records and construct indexes. As it 
does so, RMSIFL creates optimally dense buckets at all levels of each 


index. 


RMSCNV, on the other hand, optimizes only the primary index when the 
input file is sorted by the output file's primary key. However, you 
must use RMSCNV, not RMSIFL, if you do not have room for RMSIFL's sort 
work files. 


RMSIFL reads records from an input file and loads them into an indexed 
output file in six phases: 


1. RMSIFL examines the command string for errors and determines 
whether the input file is to be sorted. If the input file 
resides on a serial, nondisk device (magnetic tape, for 
example), RMSIFL will capture the input file on disk. 


2. If the input file is to be sorted, RMSIFL will read the input 
file in sequential access mode, extract the value for the 
primary key and the record's file address (RFA) for each 
record, and write the primary key and RFA to a temporary 
file. The key values will then be sorted in ascending order. 


3. RMSIFL loads the ordered records into the output file, 
constructing level 0 of the primary index a bucket at a time 
and examining each record for compatibility with the output 
File. Incompatible records are processed as "exception 
records" (see Section 3.4). 


RMSIFL also extracts the values for each of the alternate 
keys, if any, defined for the file and writes them to a 
temporary file. Finally, RMSIFL assembles the index levels 
of the primary index. 


4. RMSIFL sorts the values for each of the alternate keys in the 
temporary file by key number and ascending key value. The 
keys are sorted one at a time into another temporary file. 


5.  RMSIFL builds the alternate indexes. 


6. When processing is finished, RMSIFL prints closing messages 
and terminates. 
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Sections 3.4 and 3.5 describe these six processing phases in greater 
detail. 


The following sections describe how to invoke and terminate RMSIFL 
(Section 3.1) and the RMSIFL command string and switches (Sections 3.2 
and 3.3). Section 3.6 provides examples illustrating the use of 
RMSIFL. Appendix C, Section C.2, documents RMSIFL messages. 


3.1 INVOKING AND TERMINATING RMSIFL 


The RMSIFL utility can be either installed or uninstalled. If RMSIFL 
is installed, invoke it with the command: 


IFL [{command-string] 


If you include a command string, RMSIFL will execute the command and 
return the system prompt. 


If you do not include a command string, RMSIFL will prompt for one: 
IFL> 


If RMSIFL is uninstalled on RSX-11M/M-PLUS systems, invoke it with the 
MCR command: 


RUN SRMSIFL 


RMSIFL will respond with the prompt: 
IFL> 


In response to the prompt, you can type a command string or you can 
type CTRL/Z to terminate the utility. When RMSIFL has executed a 
command string, it returns the IFL> prompt. Section 3.2 describes the 


meee 


Indirect Command Files. You can execute series of RMSIFL command 
strings by means of indirect command files. The command strings in an 
indirect command file are executed when an at sign (@) followed by the 
file's name is specified to the utility. The default file type of 
-CMD is assumed if none is provided. 


Installed RMSIFL will accept indirect command files either from the 
system prompt or from the utility prompt. For example, to execute the 
command strings contained in the indirect command file IFLCOM.CMD, you 
could type either of the following commands: 


IFL @IFLCOM 


or 
IFL> @IFLCOM 


Uninstalled RMSIFL will accept indirect command files only from _ the 
utility prompt. For example: 


IFL> @IFLCOM 


TF wan avanntad tha indirart cammand file from the syctam nrom 
Zz we ee ee ed Neer WRAL ba Aa a ee Ne a ee wee Ne ue eee er rere 


system prompt will be returned. If you executed the indirect command 
file from within RMSIFL, the IFL> prompt will be returned. 


not tha 
Pt, Lune 
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3.2 RMSIFL COMMAND STRING 

Format 
outfile[/switch...]=infile[/switch...] 

outfile 


The specification of an RMS-11 indexed file that is to receive 
the records of the input file. 


Wild card characters are not permitted in any field of the 
specification; the default version is the highest version. 


The file must exist before you run RMSIFL, it must have no data 
in it other than the prologue, and it must have no more than 20 
keys defined. Bucket size should generally be restricted to 5 or 
fewer blocks; however, the actual bucket size supported by 
RMSIFL will vary depending on such factors as number of keys, 
size of keys, record size, amount of memory available. 


Note that RMSIFL may build an output file that is smaller than 
the input file (RMSCNV may do the same; however, the same input 
file processed by both RMSIFL and RMSCNV may result in 
different-size output files because of the different algorithms 
that the two utilities use to build files). 


infile 


The specification of the file from which records will be written 
to the output file. Wild card characters are not permitted in 
any field of the specification. The file can have any RMS-11 
file organization but must have no more than 20 keys defined. 
You cannot use a back-up file produced by RMSBCK as the input 
file (see Chapter 6). RMSIFL ignores the fixed-control area of 
variable-with-fixed-control (VFC) records in the input file. 


NOTE 


When RMSIFL opens the input file, it 
allows the file to be accessed for 
reading but not for writing. Thus, no 
writing task can access the input file 
during RMSIFL processing. 


/switch 
One of the switches listed in Table 3-1 and described in Section 
3.3. 
In place of the command string, you can type HELP or ? to display 
help text about RMSIFL, or /ID to display the current version of the 
utility. 
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Table 3-1: RMSIFL Switches — 


Type Switch Description 


Global /ID Identify current version 


Default: No identification 


Output /ER[:file-spec] Write primary keys of exception 
File records to the terminal if no 
file-spec; or write exception 


records into the specified file 
Default: Write primary keys of 
exception records to the terminal 
/NOER[:S] Stop processing if input record 
is incompatible 
Default: Write primary keys of 
exception records to the terminal 
/LO Honor fill numbers 
Default: Fill buckets 
/PD[: [#] x] Pad input records to output 
record length 


Default: Handle input as 
exception records if different 


lannanthe 
2Onguns 


/TR Truncate input records to output 
record length 


Default: Handle input as 
exception records if different 
lengths 


Input /DE:dvnl: [dvn2:...dvn5:] Reassign devices for sort work 
File files 


Default: Create and use sort 
work files on SY: 


/KRin Key of reference number 
Default: Primary key (n=0) 

/NOSO Do not sort records before loading 
Default: Sort records in input 


file before loading 


3-4 


3.3 
This 
swite 


switc 
strin 
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/ID 


3.3.2 
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RMSIFL SWITCHES 
section describes the global, output file, and input fiie 


hes that you can specify in RMSIFL command strings. Global 
hes are switches that can be specified anywhere in the command 


Ge 


Global Switch 


lobal switch is /ID. 


Displays the current version number of the RMSIFL utility. For 
example: 


IFLSOUTFIL.DAT/ID=INFILE.DAT 
IFL -- Version 2.000 


The last two digits of the version number (00 in this’ example) 
are the patch level of the utility. The /ID switch can also be 
specified by itself on the command line: 


IFL>/ID 
IFL -- Version 2.000 


Output File Switches 


The output file switches are /ER, /NOER, /LO, /PD, and /TR. 


/ER[: 


file-spec] 


Directs RMSIFL to continue processing if it encounters a _ record 
in the input file that cannot be written to the output file, that 
is, an exception record (see Section 3.4). If you specify a 
file, the exception records will be written into that file. If 
you do not specify a file, the primary key of each exception 
record will be written to the terminal. RMSIFL also issues error 
messages noting the reason for the exception record. 


If you specify a nondisk file or a terminal, RMSIFL will create 
the file as an RMS-11l sequential file with variable-length 
records when it encounters the first exception record. Then, 
RMSIFL will write both the error message and the exception 
record's primary key to the file. RMSIFL will do this for every 
exception record until it finishes processing. 


If you specify a disk file, RMSIFL will create the file as an 
RMS-11 sequential file with variable-with-fixed-control (VFC) 
records when it encounters the first exception record. Then, 
RMSIFL will write the exception record and a 4-byte exception 
code into the fixed-control area of the record. 
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The codes are: 


Code Meaning 

O01: Record is out of primary key sequence 

002: Record contains an invalid primary key 

003: Record is too short to contain output primary key 

004: Record is too long to fit in output bucket 

005: Record is not correct size for output fixed-length 
record 

006: Record is too long for maximum record size 

007: Record contains an invalid packed decimal key 


See also the /NOER switch. 


By default, if you do not specify /ER, RMSIFL will write the 
appropriate error message and the exception record's primary key 
to your terminal. 


/NOER[:S] 


/LO 


Directs RMSIFL to print an error message, delete the output file 
(unless you specify the save argument, :S), and terminate 
processing immediately if it encounters an input record that 
cannot be written into the output file (an exception record; see 
Section 3.4). 


If you specify the save argument (:S), RMSIFL will not delete the 
output file. Termination at this point, however, leaves the 
output file incomplete: it is not a valid file of any 
organization and cannot be reused for any RMS-11l purpose. Using 
the save argument is useful, for example, when your output file 
is large and contiguous and you do not want to lose any of the 
contiguous space to other users. 


By default, if you do not specify /NOER, RMSIFL will respond 
according to the form of the /ER switch specified (taking the /ER 
default of writing the primary key of each exception record to 
the terminal if /ER was not specified). 


Directs RMSIFL to write records into buckets according to the 
bucket fill size established when the file was created (see the 
RSX-11M/M-PLUS RMS-11 User's Guide for more information on fill 
numbers). 


By default, if you do not specify /LO, RMSIFL will insert as many 
records as possible into each bucket. 


/PD[: [#] x] 


Directs RMSIFL to pad records read from the input file to the 
output file's record length before writing them to the output 
file. Specify the padding character as follows: 


Switch Character 
PD NULL 
PD:x x 1S an ASCII character A-Z, 0-9, or any special 


character except #, ?, or @ 


PD: #x x is an octal number 000-377 (for example, 40 for 
SPACE, 43 for #, 77 for ?, or 100 for @) 
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You can use the /PD switch only if the output file was created 
for fixed-length records. 


When both the input and output files contain fixed-length 
records, RMSIFL requires either the /PD or /TR switch if the 
fixed-length records are not equal. If neither switch is 
specified, RMSIFL will terminate with the fatal error message: 


‘?IFL -- Input and output fixed length record sizes unequal 


When the input file contains variable-length records and the 
output file contains fixed-length records, RMSIFL may require 
both the /PD and /TR switches. If both are not specified, RMSIFL 
will terminate with the fatal error message: 


?PIFL -- /TR and/or /PD required with fixed length output records 


By default, if you do not specify /PD and the input file's 
records are shorter than the output file's records, RMSIFL will 
treat the input records as exception records (see Section 3.4.3, 
and the /ER and /NOER switch descriptions in this section). 


/TR 


Directs RMSIFL to truncate records read from the input file to 
the output file's maximum record size before writing the input 
records to the output file. The trailing bytes of the record are 
truncated. 


When both the input and output files contain fixed-length 
records, RMSIFL requires either the /TR or /PD switch if the 
fixed-length records are not equal. If neither switch is 
specified, RMSIFL will terminate with the fatal error message: 

?IFL -- Input and output fixed length record sizes unequal 
When the input file contains variable-length records and the 
output file contains fixed-length records, RMSIFL may require 
both the /TR and /PD switches. If both are not specified, RMSIFL 
will terminate with the fatal error message: 

?IFL -- /TR and/or /PD required with fixed length output records 
By default, if you do not specify /TR, RMSIFL will treat the 


input records as exception records (see Section 3.4.3, and the 
7ER and /NOER switch descriptions in this section). 


3.3.3 Input File Switches 

The input file switches are /DE, /KR, /NOSO. 

/DE:dvnl: [dvn2:...dvn5:] 
Directs RMSIFL to reassign the devices on which it allocates the 
three sort work files and the two primary and alternate key 


temporary files (see Section 3.4.2). 


The argument dvn: is a physical device name and number. 
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If you specify /DE, RMSIFL will reassign all three sort work 
files and the two key temporary files, as follows: 


e If you specify one device name, RMSIFL will reassign all five 
files to that device. 


e If you specify two device names, RMSIFL will reassign one work 
file to the first device and four files (two work and two 
temporary) to the second. 


e If you specify three device names, RMSIFL will reassign one 
work file to the first device, one work file to the second, 
and three files (one work and two temporary) to the third. 


e If you specify four device names, RMSIFL will assign each of 
the three work files to the first three devices and both 
temporary files to the fourth. 


e If you specify five device names, RMSIFL will assign one file 
to each device. 


For optimal performance, you should assign each sort work file to 
a different device. For example: 


IFL>OUTFIL.DAT=INFILE.DAT/DE:DM0O:DM1:DM2:DM3:DM4: 


However, if you have only two devices, assign the first, third, 
and fifth files to one device and the second and fourth files to 
the other device: 


IFL>OUTFIL.DAT=INFILE.DAT/DE:DM0:DM1:DMO0:DM1:DMO: 


By default, if you do not specify /DE, RMSIFL will assign the 
sort work files and the key temporary files to SY:. 


/KRin 


Directs RMSIFL to read an indexed input file according to the key 
ot reterence specified by n: nis 0 for the primary key, 1 for 
the first alternate key, and so on up to 19. The /KR switch can 
eliminate the need for RMSIFL to sort the input file (see Section 
3.4.1). 


You can specify /KR only with indexed input files. Otherwise, 
RMSIFL will terminate with a fatal error message. 


By default, if you do not specify /KR and the input file is 
indexed, RMSIFL will read the file using the primary key as the 
key of reference, 


/NOSO 


Directs RMSIFL to bypass the primary key sorting phase of 
processing (see Section 3.4.1) because the input file is already 
sorted. If the input file is not in ascending order by the 
output file's primary key, RMSIFL'sS response will depend on 
whether you have specified /NOER or a form of /ER with the output 
file specification (see Section 3.3.2). 


Note that RMSIFL will still sort the alternate keys even if /NOSO 


2 nal 
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By default, if you do not specify /NOSO, RMSIFL will sort all 
records from the input file into the proper order (see Section 
3.4.2). 
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3.4 RMSIFL PROCESSING 


RMSIFL reads records from an input file, sorts them (if necessary), 
and loads them into an empty indexed RMS-11 output file in six phases, 
described in the following sections. 


3.4.1 Checking the Command String 


RMSIFL first examines the command string for syntax and other errors. 
If it finds an error, it will print an error message and prompt for a 
new command string. When a valid command string is entered, RMSIFL 
determines whether the input file must be sorted in ascending order by 
the output file's primary key (the second phase of RMSIFL processing; 
see Section 3.4.2). 


RMSIFL will bypass the primary key sorting phase if you have specified 
either the /NOSO or /KR input file switch (see Section 3.3.3). The 
/NOSO switch directs RMSIFL to bypass sorting because you have already 
sorted the input file. 


The /KR switch specifies a key of reference for an indexed input file. 


If the key of reference specified is equal to or contains the output 
primary key, based on position only, RMSIFL will bypass the sorting 
phase. Nonstring key types must match exactly in starting position 


and length. String keys must start in the same position, but the 
Output primary key can be the same length or shorter than the input 
key of reference. 


For example, if the 10-byte string input primary key starts at byte 0 
and the 8-byte string output primary key starts at byte 3, RMSIFL will 
sort the input file. However, if the 10-byte string input alternate 
key starts at byte 0 and is specified as the key of reference, and the 
8-byte string output primary key starts at byte 0, RMSIFL will not 
sort the input file. 


For another example, if the 3-byte packed decimal input alternate key 
1 starts at byte 43 and is specified as the key of reference, and the 
3-byte packed decimal output primary key starts at byte 42, RMSIFL 
will sort the input file. 


RMSIFL notifies you that it has started processing by printing the 
message: 


PRIMARY KEY 


3.4.2 Reading and Sorting the Input Records 


RMSIFL reads the input file in sequential access mode, depending on 
the organization of the input file: 


Input File 
Organization Processing 
Sequential RMSIFL reads the records in sequential access 
mode, starting with the first record in the file. 
Relative RMSIFL reads the records in sequential access 
mode, starting with record cell l. 
Indexed RMSIFL reads the records in sequential access 


mode, following the key of reference. 
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RMSIFL passes the primary key from each record to the sort routines, 
which are provided with RMSIFL. These routines sort the keys into 
ascending order. At the beginning of this phase, RMSIFL initially 
allocates disk space for three sort work files (see Section 3.5). 
(You can use the /DE input file switch to specify the disks to which 
these files are assigned; see Section 3.3.3.) 


RMSIFL indicates the start and finish of this phase by printing the 
messages: 


SORT HAS STARTED 
SORT MERGE PHASE HAS FINISHED 


If an error occurs during the sorting, RMSIFL will terminate with the 
message: 


SORTS ERROR CODE IN OCTAL:nn 
See Appendix D for a description of the sort routine error codes. 


At the end of this phase, RMSIFL deletes the sort work files. As 
Output from this phase, RMSIFL creates a file, IFLP.TMP, containing 
the RFA from each record in the input file, sorted in ascending order 
by primary key. See Section 3.5. 


3.4.3 Loading Records in the Output File 


RMSIFL loads the ordered input records into the output file, 
constructing level 0 of the primary index (the data level) a bucket at 
a time (see the RSX-11M/M-PLUS RMS-11 User's Guide for information on 
the primary index). 


If the records were sorted in the previous processing phase, RMSIFL 
will read the RFA for each record from IFLP.TMP, then read the 
associated record, by RFA, from the input file. IFLP.TMP is deleted 
at the end of this phase. 


If the records were not sorted in the previous processing phase (see 
Section 3.4.1), RMSIFL will read the records in sequential order from 
the input file. 


RMSIFL examines each input record to ensure that it is compatible with 
the output file. If the record is not compatible, RMSIFL processes it 
as an exception record according to the /ER or /NOER input file switch 
specified in the command string (see Section 3.3.3). Exception 
records can occur for any of the following reasons: 


e You specified the /NOSO input file switch and RMSIFL found a 
record that was not in ascending order by the output file's 
primary key. 


e You did not allow duplicates in a key of the output file, but 
an input file record contains a duplicate value in that key 
field. 


e An input record is not long enough to contain the primary key 
of the output file. 


ig to fit in a bucket of the output 
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e An input record is not compatible with the output file's 
fixed-length record format and you did not specify the /PD 
and/or the /TR switch. 


@e An input record is longer than the output file's 
variable-length maximum record size and you did not specify 
the /TR switch. 


@e An input record contains an invalid packed decimal key: a 
digit half-byte is greater than 9 or the sign half-byte is 
less than 10. 


In all these cases, RMSIFL issues an appropriate nonfatal error 
message noting that an exception record has occurred and why, and 
continues processing. 


If RMSIFL encounters an exception record while processing alternate 
index(es), it flags as deleted the data records in the primary index. 
RMSIFL does not remove the record from the file. The record can be 
compressed during later use of the indexed file (see the 
RSX-11M/M-PLUS RMS-11 User's Guide). 


You can add corrected exception records to the output file after 
RMSIFL terminates by using either an application program or RMSCNV 
(possibly using your terminal as the input device; see Chapter 4). 


If the record being read is compatible, RMSIFL inserts it into a 
level-0 bucket being built in memory. 


As RMSIFL places each record in the output file, it extracts the 
values for each of the alternate keys defined for the file, if any: 


@e RMSIFL combines the alternate key value with the record file 
address (RFA) of the user data record that supplied the key 
value. RFAsS are 6 bytes long. RMSIFL then appends a byte 
with the key number. 


e  RMSIFL writes the alternate key records into a _ separate 
temporary file, IFLA.TMP, which is marked for deletion. 
RMSIFL allocates disk space for this file as described in 
Section 3.5. 


During this phase, RMSIFL also assembles the index levels of the 
primary index. RMSIFL puts an index record into a level-1l bucket for 
each level-0 bucket it writes to the file. When it writes a level-l 
bucket, RMSIFL inserts an index record in a level-2 bucket and so on 
up to and including the root. 


RMSIFL indicates the start and finish of this phase by printing the 
messages: 


LEVEL-0 LOADING HAS STARTED 
LOADING HAS FINISHED 


3.4.4 Sorting the Alternate Key Temporary File 


RMSIFL sorts the alternate key temporary file by key number. and 
ascending key value, using the same sort routines as in phase 2 (see 
Section 3.4.2). Nonstring key data types are converted to a 
string-like representation for sorting only. 
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If there is_-more than one alternate key, RMSIFL will sort one at a 
time, building each alternate index after that index's keys have been 
sorted (see Section 3.4.5). 


For each alternate key, RMSIFL allocates the disk space for three sort 
work files, as described in Section 3.5. 


RMSIFL indicates the start and finish of this phase by printing the 
message: 


ALTERNATE KEY(S) 


At the end of each alternate key sort, RMSIFL deletes the sort work 
files. As output from each sort, RMSIFL creates a temporary file, 
IFLAL.TMP, which contains the key values and RFAsS for an alternate 
key. 


3.4.5 Building the Alternate Indexes 


RMSIFL builds the alternate indexes one at a time from level 0 up to 
the root, using the sorted temporary file, IFLA1L.TMP, for each key for 
input. 


RMSIFL prints the following message as it constructs each alternate 
index: 


KEY nnn 


The variable nnn starts at l. 


3.4.6 Terminating Processing 


RMSIFL prints the following messages when the output file is 
completely loaded, then terminates processing of the current command 
String: 

NUMBER OF INPUT RECORDS: nnnnnnnnn 

NUMBER OF OUTPUT RECORDS: nnnnnnnnn 

NUMBER OF EXCEPTION RECORDS: nnnnnnnnn 


NOTE 


RMSIFL extends the output file if it 
cannot contain the input records and the 
index(es). The utility minimizes this 
overhead by extending the file a set 
quantity each time it requires space. 
This quantity is the integral multiple 
of bucket size less than or equal to 50. 


3.5 CALCULATING TEMPORARY FILE WORK SPACE 


If the input file is on a serial, nondisk device, RMSIFL must capture 
the file:on disk before it can process the file. The file captured on 
disk is the same size as the input file. This file is deleted after 
the primary index is built. 
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At the beginning of phase 2 (see Section 3.4.2), RMSIFL allocates disk 
space for three sort work files, calculating the space for each as 
Follows: 

1.5 * NDRF * (6 + PKS + PAD)/512. 

1/8 the size of the input file, whichever is larger. 


NRDF is the number of user data records in the input file. 


PKS is the size of the primary key, in bytes (plus 1 for packed 
decimal keys). 


PAD is the number of null bytes added to word-align the record: 


PAD 0 if PKS is an even number 
PAD = 1 if PKS is an odd number 


The output from this phase, IFLP.TMP, is allocated disk space as 
follows: 


6 * NRDF/512. 
In phase 3, if alternate keys are defined for the output file (see 
Section 3.4.3), RMSIFL will create the temporary file IFLA.TMP with an 
initial allocation of 100 blocks and a default extension quantity of 
100 blocks. The final size of this temporary file is calculated as 
follows: 

(NDRF * NAK * (7 + LKS + PAD))/512. 
NDRF is the number of user data records in the input file. 


NAK is the number of alternate keys defined for the output file. 


LKS is the size of the largest alternate key defined for the output 
file, in bytes (plus 1 for packed decimal keys). 


PAD is the number of null bytes added to word align the record: 


PAD 0 if PKS is an even number 


PAD 1 if PKS is an odd number 


In phase 4, RMSIFL sorts the alternate keys one at a time (see Section 
3.4.4). To sort each key, RMSIFL creates three sort work files, 
calculating the disk space for each as follows: 

1.5 * NDRF * (6 + AKS + PAD) /512. 
NDRF is the number of user data records in the input file. 


AKS is the size of the alternate key, in bytes (plus 1 for packed 
decimal keys) 


PAD is the number of null bytes added to word align the record: 
PAD = 0 if PKS is an even number 


PAD 


1 if PKS is an odd number 
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The. output from each alternate key sort, IFLAL.TMP, is allocated disk 
space as follows: 


NDRF * (6 + AKS)/512. 


Note that if the /DE output file switch is specified (see Section 
3.3.3), IFLAL.TMP will be assigned to the same device to which 
IFLP.TMP was assigned. 


3.6 RMSIFL EXAMPLES 


>IFL PAYROL.DAT=PAYROL.SEQ 

Primary key 

Sort has started 

Sort merge phase has finished 

Level-0 loading has started 

Loading has finished 
Alternate key(s) 
Alternate key l 


Number of input records: 448 
Number of output records: 448 
Number of exception records: 0 


In this example, RMSIFL loads a sequential input file into an empty 
output indexed file. RMSIFL sorts the input records and reports the 
total number of records processed. 


>IFL VHC. INX/TR/NOER=VHC.SEQ 
Primary key 
Sort has started 
Sort merge phase has finished 
Level-0 loading has started 
Loading has finished 


Alternate key 1 


Number of input records: ll 
Number of output records: ll 
Number of exception records: 0 


RMSIFL sorts the input records from the file VHC.SEQ and _ truncates 
them to fit the maximum record size of the output file records in 
VHC.INX. There are no exception records, so the RMSIFL command 
completes successfully. 


>TYP VHCKRO.DES 

GET VHC.INX DAT 

SET FILE NAME VHCKRO.INX 

SET FILE SUPERSEDE YES 

SHOW ALL 

CREATE 

>DES @VHCKRO.DES 

SYSTEM 
Target RSX 
Source RSX 
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FILE 
Name VHCKRO.INX (Explicit) 
Organization INDEXED 
Allocation 62 
Extension 1 
Bucket Size 4 
Protection (SYSTEM: RWED, OWNER: RWED, GROUP:RWED, WORLD:?R 
Owner [70,5] 
Max Record Number 0 
Contiguous — NO 
Supersede YES (Explicit) 
RECORD 
Size 80 
Format FIXED 
Control Field Size 0 


Carriage Control 
KEY 0 


CARRIAGE RETURN 


Name NPANXX 
Type STRING 
Null Key NO 
Null Value 0 
Duplicates NO 
Changes NO 
SegO Position a 
SegO Length 6 
Data Fill 50 
Data Area 0 
Index Fill 50 
Levell Index Area 0 
Index Area _ 0 

KEY rE 
Name PLACE 
Type STRING 
Null Key NO 
Null Value 0 
Duplicates YES 
Changes YES 
Seg0 Position 59 
Seg0 Length 12 
Data Fill 50 
Data Area 0 
Index Fill 50 
Levelil Index Area 0 
Index Area ~_ 0 

AREA 0 
Allocation 40 
Extension 0 
Bucket Size 4 
Contiguous NO 
Position NONE 0 
Exact Positioning NO 


>IFL VHCKRO. INX/ER: VHC. ERR=VHC. INX/KR:1/NOSO 
Primary key 
Level-0 loading has started 
Loading has finished 
Alternate key(s) 
Alternate key l 


Number of input records: 11 
Number of output records: 6 
Number of exception records: 5 


~~ 
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First.,..RMSDES-is--used to. create an-indexed-file;-VHCKRO.INX. 


Note that a RMSDES GET command is used to get the file attributes of 
the VHC.INX file: the contents of the DES GET file are shown 
initially, and then the DES file is invoked. 


Next, RMSIFL takes the input records from the indexed file VHC.INX, in 
the order of the first alternate key, and puts them in the output 
indexed file. 


Because the /NOSO switch is specified, RMSIFL assumes that the records 
are ordered properly already. In this case, five exception records 
are generated and placed in the file VHC.ERR because the records are 
actually out of sequence for the primary key. 
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CHAPTER 4 


RMS-11 FILE CONVERSION UTILITY: RMSCNV 


The RMS-11 File Conversion Utility (RMSCNV) reads records from an 
RMS-11 file of any type and loads them into another RMS-11 file of any 
type. For example, RMSCNV can: 


@e Create a new sequential file from the records of an existing 
sequential, relative, or indexed file 


ing sequential file with the records of 
1 file, or the records of a relative or 


@e Supersede an exist 
za 


; 
; 

AMA 

another sequentl 


indexed file 


e Append the records of one sequential file to another 
sequential file, or the records of a relative or indexed file 
to a sequential file 


@e Write the records of a sequential, relative, or indexed file 
into another file of any organization 


On operating systems with DECnet network capabilities and on which 
RMSCNV has Data Access Protocol (DAP) support, RMSCNV file conversions 
can take place over the network. That is, in addition to local file 
conversions, you can convert files between a local and a remote node, 
or between two remote nodes. 


In Figure 4-1, the user is running RMSCNV on an RSX-11M/M-PLUS system 
to convert a file on a RSTS/E system to a new file on a VAX/VMS 
system. The /CA switch creates the output file on the VAX/VMS system 
with the same attributes as the input file and copies the input file 
records into it. The /SL switch writes the summary listing to a file 
on the RSX-11IM/M-PLUS system under the user's UIC. 


See Section 4.3 for more information about the /CA and /SL_ switches. 
See the RSX-11M/M-PLUS RMS-11 User's Guide for more information about 
file specifications. 


RMSCNV uses the standard RMS-11 access methods to build the output 
file. Unlike RMSIFL (see Chapter 3), RMSCNV optimizes only the 
primary index when the input file is sorted by the indexed output 
file's primary key. However, RMSCNV allows you to add records from an 
input file to an output file that already contains records (RMSIFL 
loads only empty output files). 


In addition, RMSCNV can read and write records in block mode. 


RMS-11 FILE CONVERSION UTILITY: RMSCNV 


rei Osen any 


SUM.LST 


DECnet 


RSX-11M/M-PLUS 
SYSTEM 


RSTS/E SYSTEM VAX/VMS SYSTEM 


DECnet/VAX 


DECnet/E 


DB1:({100, 100]IN.DAT DBA1:[USERJOUT.DAT 


ZK-1124-82 


Figure 4-1: Using RMSCNV with DECnet 


You can use RMSCNV to perform the following operations: 


Copy any RMS-11 file to magnetic tape. RMSCNV will convert 
the file to a sequential file. You can recopy the file to 
disk by redefining the original file using RMSDES (see Chapter 
2) and then rerunning RMSCNV (or running RMSIFL for indexed 
files) to load the records from the tape. ) 


Print any RMS-l1l file with carriage-return control. RMSCNV 
can convert the file for output directly to a line printer, or 
it can convert the file's records to variable format with 
carriage return control so the file can be queued to a line 
printer. 


NOTE 


RMS-11 does not convert numeric or 
binary data to ASCII data. 


Reestablish areas of contiguity to files restored by RMSRST. 
Use RMSDES to create the file with the attributes you want and 
use RMSCNV to populate the file with the single~area, 
noncontiguous file produced by RMSRST (for indexed files, it 
is suggested that you use RMSIFL; see Chapter 3). 
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e Convert ASCII stream files to RMS-11 file organizations by 
first creating the new file using RMSDES. When possible, if 
you are building a relative or indexed file, sort the ASCII 
file by relative record number or by primary key. Then build 
the new file using RMSCNV. 


For example, one application of RMSCNV might be as_ follows: daily 
processing is done using a small file designed for that purpose. At 
the end of the day, RMSCNV can be used to add the records in the small 
file to a larger, master file. In addition, RMSCNV's ability to 
convert ASCII stream files to RMS-11 file organizations can be useful 
in intersystem migration (for example, RSTS/E to RSX-11M). 

All RMSCNV functions involve the movement of records from one file to 
another. The manner in which RMSCNV reads records from the specified 
input file and writes them to the specified output file depends on the 
file organization of both the input and output files and on the 
Switches you specify in the command string. Section 4.4 describes 
RMSCNV processing in greater detail. 

The following sections describe how to invoke and terminate RMSCNV 
(Section 4.1) and the RMSCNV command string and switches (Sections 4.2 


and 4.3). Section 4.5 provides examples illustrating the use of 
RMSCNV. Appendix C documents messages. 


4.1 INVOKING AND TERMINATING RMSCNV 


The RMSCNV utility can be either installed or uninstalled. If RMSCNV 
is installed, invoke it with the command: 


CNV [command-string]} 


If you include a command string, RMSCNV will execute the command = and 
return the system prompt. 


If you do not include a command string, RMSCNV will prompt for one: 
CNV> 


If RMSCNV is uninstalled on RSX-11M/M-PLUS systems, invoke it with the 
MCR command: 


RUN SRMSCNV 
Note, however, that uninstalled RMSCNV will respond with a prompt that 
reflects the current process name (abbreviated to 3 characters). For 
example: 

RUN SRMSCNV 

>TT Ls 
You can install RMSCNV with another name as follows: 


INS SRMSCNV/TASK=...XXxX 


where xxx is a 3-character name that you chose for the utility. The 
utility will then prompt: 


XXX> 
RMSCNV will respond with the prompt: 


CNV> 
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In response to the prompt, you can type a command string or you can 
type CTRL/Z to terminate the utility. When RMSCNV has executed a 
command string, it returns the CNV> prompt. Section 4.2 describes the 
RMSCNV command string. 


Indirect Command Files. You can execute series of RMSCNV command 
strings by means of indirect command files. The command strings in an 
indirect command file are executed when an at sign (@) followed by the 
file's name is specified to the utility. The default file type of 
-CMD is assumed if none is provided. 


Installed RMSCNV will accept indirect command files either from the 
system prompt or from the utility prompt. For example, to execute the 
command strings contained in the indirect command file CNVCOM.CMD, you 
could type either of the following commands: 


CNV @CNVCOM 
or 
CNV> @CNVCOM 


Uninstalled RMSCNV will accept indirect command files only from _ the 
utility prompt. For example: 


CNV> @CNVCOM 


If you executed the indirect command file from the system prompt, the 
system prompt will be returned. If you executed the indirect command 
file from within RMSCNV, the CNV> prompt will be returned. 


4.2 RMSCNV COMMAND STRING 


On systems with DECnet network capabilities and on which RMSCNV has 
DAP support, both the output file and input file can be on remote 
network nodes. See the RSX-11M/M-PLUS RMS-11 User's Guide for more 
information on file specifications. 


If either the input file or the output file is relative or indexed, 
the bucket size should, in general, be no greater than 15 blocks. The 
actual allowable bucket size for either file, however, will depend on 
many factors directly related to processing, such as: maximum record 
Size for either file, number of keys for either file, whether /SL 
and/for /IM is specified, whether the network is configured, and so 
forth. 


Note that if the maximum record sizes for the input and output files 
are different, you may have to specify the /PD or /TR switch or both 
(see Section 4.3). 
Format 
{outfile[/switch...J=]infile[/switch...] 
outfile 
The specification of the file that is to receive the records of 
the input file. Wild card characters are not permitted in any 


field of the specification. 


RMSCNV will automatically create a sequential output file if one 
does not already exist. 
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Note, however, that when you specify the /EO switch, an output 
file specification is not allowed, and no output file will be 
created. See Section 4.3 for more information on the /EO switch. 
The default version for existing sequential output files (those 
specified with the /AP or /SU switch; see Section 4.3), for 
relative files; and for indexed files is the highest version; if 
an existing sequential file is specified and neither the /AP nor 
the /SU switch is specified, RMSCNV will use the highest existing 
version number plus l. 


A relative or indexed output file must exist before RMSCNV is 
invoked (unless you specify the /CA switch; see Section 4.3). 
You can create the file using either an application program or 
the RMSDES utility (see Chapter 2). 


RMSCNV may build an output file that is smaller than the input 
file. (RMSIFL may do the same; however, the same input file 
processed by both RMSCNV and RMSIFL may result in different-size 
output files because of the different algorithms that the two 
utilities use to build files.) 


You can specify a unit record device, such as a terminal or a 
line printer, as the output file. Specify the current user's 
terminal as TI:. By default, if no output file is specified, the 
records of the input file are written to your terminal (that is, 
TI: is the default). 


infile 


The specification of the file from which records will be written 
to the output file. Wild card characters are not permitted in 
any field of the specification. 


You cannot use a back-up file produced by RMSBCK as the input 
file (see Chapter 6), except to copy the file using the /IM 
Switch (see Section 4.3). 


You can specify a unit record device, such as a card reader or 
terminal, as the input file. Specify the current user's terminal 
as TI:. End terminal input with CTRL/Z. 


/switch 


One of the switches listed in Table 4-1 and described in Section 
4.3. All switches are global; that is, they can be specified 
anywhere in the command string. 


In place of the command string you can type HELP or ? to display help 
text about RMSCNV, or /ID to display the current version of the 
utility. 
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Table 4-1: RMSCNV Switches 
Switch Description 
/AP Append records to an existing 
sequential file 
Default: No appending 
/BL[:n] Set magnetic tape block size 


Default: 512 bytes 


/CA{:file-spec] Create an output file with the 
attributes of an existing input file 


Default: Output file must exist or a 
sequential file will be created 


/EO Convert CTRL/Z end-of-file character 
in an ASCII stream file to null and 
pad the file with nulls to the 
physical end of file 


Default: Assume null-filled stream 
file 
/FO:% Set output file organization, where x 


is S, R, or I 

Default: Sequential (S) 
/1ID Identify current version 

Default: No identification 
/IM Process files in block mode 


Default: Use standard RMS-1l access 
methods 


/KN: ["] keyname["] Read an indexed file using the key of 
reference specified by keyname 


Default: Read file using primary key 


/KRin Read an indexed file using the key of 
reference specified by n 


Default: Read file using primary key 
(0) 


/LO Honor bucket fill size when filling 
buckets in the output indexed file 


Default: Fill buckets to capacity 


/MA Use mass-insertion mode and sequential 
PUT operations 


: No mass insertion; random PUT 
oms 


(continuted on next page) 
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Table 4-1 (Cont.): RMSCNV Switches 


/ML 


/PD 


/SL 


/SU 


/TR 


/WE 


/AP 


Switch Description 
tn Explicitly set limit of buffer 
allocation 
Default: Allow RMSCNV to calculate 
the amount of memory available for 
allocation 
im ee Ge a eae Pad input records to output record 
length 
Default: No record padding 
[:file-spec] Provide summary listing (in file, if 
specified) 
Default: No summary 
Supersede existing sequential file 
Default: No supersession 
Truncate input records to output 
record length 
Default: No record truncating 
Write or read fixed-control area 
Default: Ignore fixed-control area 
RMSCNV SWITCHES 


Directs RMSCNV to append records to an existing sequential output 
file. That is, RMSCNV adds the input file records to the end of 
the output file. You cannot specify /AP and /SU in the same 
command string. If the output file is not sequential, RMSCNV 
will ignore the /AP switch. 


By default, if you do not specify /AP, RMSCNV will respond 
according to whether you have specified /SU: 


e If you specified /SU, RMSCNV supersedes the existing 
sequential output file. 


e If you did not specify /SU and the output file exists, RMSCNV 
will create the next higher version of the file. 


See also the description of the /SU switch. 
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yBLtin) 


Specifies the physical block size of the output file when it is 
being created on magnetic tape. The argument n must be a number 
from 18 to 8192 (decimal). If you do not specify n, RMSCNV will 
use a tape block size of 512 (decimal) characters. You can 
specify /BL only with sequential tape files. If you specify /BL 
with other files, RMSCNV will return the following error message: 


SCNV-F-IAS, Illegal use of /AP, /BL, or /SU with file 
organization 


By default, if you do not specify /BL, RMSCNV will use aé_ tape 
block size of 512 (decimal) characters. 


/CA[:file-spec] 


/EO 


Directs RMSCNV to create an output file with the attributes of an 
existing file and to copy the records of the input file into it. 


If you specify a file with /CA, RMSCNV will create the output 
file with the attributes of the specified file. 


If you do not specify a file with /CA, RMSCNV will create the 
output file with the attributes of the input file. 


Note, however, that if the existing file is indexed and contains 
multiple areas, these areas will not be preserved in the newly 
created file. The new file will be a single-area file. Its 
bucket size will be that of the largest bucket size in the 
multiple-area file. Bucket fill size also will not be preserved. 
RMSCNV will insert as many records as possible into each bucket. 
Two informational messages will be issued when this occurs: 


$CNV-W-OOA, Output file will contain only one area 


S$CNV-W-FOL, Output indexed file fill quantities will not be 
preserved 


By default, if you do not specify /CA, the requirements’) and 
defaults for output file specifications apply (see Section 4.2). 


Converts a CTRL/Z end-of-file character in ASCII stream files to 
a null character (ASCII 000) and fills the remainder of the file, 
to the physical end-of-file, with null characters. 


Note that when you specify /EO, an output file specification is 
not allowed, and no output file will be created. /EO operates 
directly on the input file. For example: 

CNV>INFILE.DAT/EO 
After processing, INFILE.DAT will be null-filled to end-of-file. 
If the CTRL/Z signals both end-of-record and end-of-file, the 


CTRL/Z is retained as the end-of-record character and the 
remainder of the file is null-filled. 
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NOTE 


RMS-11 no longer recognizes CTRL/Z as an 
end-of-file character. Therefore, ASCII 
stream files that end with CTRL/Z should 
be converted, using this switch, to the 
format recognized by RMS-11 
(null-filled). If you specify a file 
that ends with CTRL/Z and do not specify 
/EO, the CTRL/Z character will become 
part of the data in the file; it will 
no longer signal end-of-file. 


By default, if you do not specify /EO, RMSCNV will assume that 
the input stream file is padded with null characters from logical 
to physical end-of-file. 


/FO:X 


Specifies the organization of the output file. The argument <x 
must be one of the following: 


S -- sequential file 
R -- relative file 
I -- indexed file 


By default, if you do not specify /FO, RMSCNV will use sequential 
organization and create an output file with the attributes of the 
input file (see Section 4.4.1). 


/1ID 
Displays the current version of the RMSCNV utility. For example: 
CNV>OUTFIL.DAT/ID=INFILE.DAT 
$CNV-I-ID, Version 2.000 
The last two digits of the version number (00 in this’ example) 
are the patch level of the utility. The /ID switch can also be 
specified by itself on the command line: 
CNV>/ID 
$CNV-I-ID, Version 2.000 
/ IM 


Directs RMSCNV to read the records of the input file and write 
the records to the output file block by block, that is, in block 
access mode. 


You can use the /ML switch with /IM 
blocks to be processed in a Single R 
the description of the /ML switch. 


o spec 


fy the number of 
AD or WRIT 


t 
E TE operation. See 


By default, if you do not specify /IM, RMSCNV will convert files 
using the standard RMS-11 access methods. 
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/KN: ["]keyname["] 


Directs RMSCNV to read an indexed file based on the key named in 
the argument keyname (key name assignment is an optional 
capability provided by RMSDES; see Chapter 2). 


The quotation marks are required only if the key name contains 
spaces, special characters, or lowercase letters. 


You can specify /KN only for indexed files. Otherwise, RMSCNV 
will terminate with the fatal error message: 


?CNV-F-IAX, Illegal use of /KN, /KR, /LO, or /MA with file 
organization 


See also Section 4.4.2 for a way to use /KN to examine an indexed 
input file at your terminal. 


You cannot specify /KN and /KR in the same command string. 


By default, if you do not specify /KN (and you also have not 
specified /KR) and the input file is indexed, RMSCNV will read 
the file using the primary key as the key of reference. 


/KRin 


Directs RMSCNV to read an indexed input file based on the _ key 
numbered n: n is 0 for the primary key, 1 for the first 
alternate key, and so on. 


You can specify /KR only with indexed input files. Otherwise, 
RMSCNV will terminate with the fatal error message: 


?CNV-F-IAX, Illegal use of /KN, /KR, /LO, or /MA with file 
organization 


2 for a way to use /KR to examine an indexed 
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You cannot specify /KR and /KN in the same command string. 


By default, if you do not specify /KR (and you also have not 
specified /KN) and the input file is indexed, RMSCNV will read 
the file using the primary key (0) as the key of reference. 


/LO 


Directs RMSCNV to write records into buckets of an indexed file 
according to the bucket fill sizes established when the file was 
created. See the RSX-11M/M-PLUS RMS-11 User's Guide for more 
information on bucket fill sizes. You can specify /LO only with 
indexed output files. Otherwise, RMSCNV will terminate with the 
following error message: 


?CNV-F-IAX, Illegal use of /KN, /KR, /LO, or /MA with file 
organization 


By default, if you do not specify /LO, RMSCNV will insert as many 
records as possible into each bucket. 


/MA 


Directs RMSCNV to use mass-insertion mode (see the RSX-11M/M-PLUS 


RMS-LL user's Guide) ang sequenti 
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records into an indexed output file. Your indexed input file 
must be sorted in ascending order by the output file's primary 
key. Otherwise, RMSCNV will terminate with the fatal error 
message: 


?CNV-F-ERSSEQ, Record not in proper key sequence for file 
<file-spec> 


Mass-insertion mode provides improved performance only if records 
are to be inserted at the logical end-of-file. Therefore, either 
the output file should be empty, or the input file should contain 
records with primary key values greater than the primary key 
value of the highest record that currently exists in the output 
file. If the input records do not meet this requirement, RMSCNV 
will continue to process them. However, it will not achieve the 
improved performance otherwise possible with mass-insertion mode. 


For example, suppose you have two indexed files, IDX.IN and 
IDX.OUT. The primary key of IDX.IN is defined as bytes 0 through 
15 of each record, and the primary key of IDX.OUT is defined as 
bytes 0 through 8 of each record. Because RMS-11 orders records 
in indexed files according to primary key value, you can convert 
IDX.IN to IDX.OUT using the /MA switch with the default key of 
reference. 


Note that if the primary key of IDX.OUT is the same as an 
alternate key of IDX.IN, you can still use the /MA switch if you 
specify the proper alternate key with the /KR input file switch 
(see Section 4.3.3). 


You can specify /MA only with indexed output files. Otherwise, 
RMSCNV will terminate with the following error message: 


?CNV-F-IAX, Illegal use of /KN, /KR, /LO, or /MA with file 
organization 


By default, if you do not specify /MA, RMSCNV will use random PUT 
operations to insert each record in the output file. 


/MLin 


If you are using block access mode (that is, also specifying 
/IM), /ML specifies the number of blocks to be processed in a 
Single READ or WRITE operation. (See also the description of the 
/7IM switch.) 


If you are using the standard RMS-1l access modes, /ML specifies 
the amount of memory available to be allocated to all buffers for 
the conversion operations, where n specifies K words (1K=1024). 


You can use this switch to override RMSCNV's memory calculation 
routines and explicitly specify memory allocation. 


You can specify any positive number for n; if n is too large for 
the amount of memory available, RMS-11 will issue a fatal error 
message: 


?CNV-F-MLE, Block value of /ML switch exceeds limit or 
available memory 


If n is too small or if you specify /ML:1, RMS-11l will allocate 
minimal amounts of memory. If n is 0, RMSCNV'S memory 
calculation routines will be used (this is the same as not 
specifying /ML). 
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By default, if you do not specify /ML, RMSCNV's memory 
calculation routines will be used to calculate the amount of 
memory available for the conversion operations. 


/PD[: f#] ("] x0") ] 


Directs RMSCNV to pad records read from the input file. You use 
/PD when the output file has fixed-length records and a maximum 
record size greater than the input file's maximum record size. 
(The input file's records can be either variable or fixed 
length.) 


In addition, when the output file contains fixed-length records, 
the input file contains variable-length records, and the output 
file's maximum record size is less than the input file's, you 
must specify both /PD and /TR. If both are not specified, RMSCNV 
will terminate with the fatal error message: 

?CNV-F-TPM, Switch /TR or /PD or both are needed for this CONVERT 
(See also the description of the /TR switch.) 


Specify the padding character as follows: 


Switch Character 
/PD{:] NULL (byte value 000). 
/PD: [#] x x is an octal number 000 to 377 (43 for #, 77 for ?, 


and 100 for @). The number sign (#) is optional; 
RMSCNV will check first for an octal number. 


/PD:["}]x[{"] ‘-® is an ASCII character A to Z, 0 to 9, or any 
special character. The quotation marks are required 
for #, lowercase letters, or a space; otherwise, 


the quotation marks are optional. If the quotation 
marks are not present, RMSCNV will check first for 


an octal number: then it will check for an ASCII 
character. 
By default, if you do not specify /PD and the input file's 
records are shorter than the output file's records, RMSCNV will 
terminate with the fatal error message: 
?CNV-F-MRS, Input and output record sizes do not correspond 
/SLi:file-spec] 


Directs RMSCNV to produce a= summary of file conversion 
processing. The summary listing consists of the following: 


@e The options (Switches) in effect 


e The input and output file organization, file attributes, 
record format, and record attributes 


e A summary of messages produced during RMSCNV execution 
@® The number of input records read and output records written 
e The count of padded records if /PD was selected 


e The count of truncated records if /TR was selected 
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If you specify a file as an argument to /SL, and a file of the 
Same name and type already exists, RMSCNV will append the summary 
to that file. You can thus use one file to keep a record of all 
conversions. 


If you specify a file, and a file of the same name and type does 
not exist, RMSCNV will create a new fiie and write the summary to 
that file. 


If you do not specify a file, the summary will be written to your 
terminal. 


Do not specify either the input file or the output file as _ the 
argument to /SL. 


By default, if you do not specify /SL, no summary listing will be 
produced. The messages written to your terminal (if RMSCNV 
encounters any errors) will be the only record of file conversion 
processing. 


/SU 


Directs RMSCNV to supersede an existing sequential output file. 


MMaMaIt?T . 
RM 


SCNV deletes the existing file, creates one of the same name, 
type, and version, and writes the records of the input file to 
it. 

You cannot specify /SU and /AP in the same command string. 


By default, if you do not specify /SU, RMSCNV will respond 
according to whether you have specified /AP: 


e If you specified /AP, RMSCNV will append the input records to 
the output file. 


e If you did not specify /AP and the output file exists, RMSCNV 
will create the next higher version of the file. 


See also the description of the /AP switch. 

/TR 
Directs RMSCNV to truncate records read from the input file to 
the output file's maximum record size. The trailing bytes of the 


record are ignored. 


You must use /TR when the input file's maximum record size is 
greater than the output file's. 


In addition, when the output file contains fixed-length records 

and the input file contains variable-length records, you must 
specify both /TR and /PD. If both are not specified, RMSCNV will 
terminate with the fatal error message: 

?CNV-F-TPM, Switch /TR or /PD or both are needed for this CONVERT 

(See also the description of the /PD switch.) 

By default, if you do not specify /TR and the input file's 
records are longer than the output file's records, RMSCNV will 


terminate with the fatal error message: 


?CNV-F-MRS, Input and output record sizes do not correspond 
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Directs RMSCNV to handle variable-with-fixed-control (VEC) 
records in either the input or output file. RMSCNV processes the 
possible combinations of input and output file record formats, as 
follows: 


Input Output 
Filel File! Processing 


VEC VEC If the fixed-control areas are the same _ size, 
RMSCNV will perform a straightforward copy 
operation. If the areas are not the same _ size, 
RMSCNV will terminate, without converting the 
file, with the fatal error message: 


?CNV-F-VFC, Input and output fixed control header 
sizes do not correspond 


VFC FIX The fixed-control area of each input record is 
VAR written as the first n bytes of each output 
STM record; nis the size of the fixed-control area. 
The variable portion of the input record completes 
the output record. 


FIX VFC The first n bytes of each input record are written 
VAR into the fixed-control area of each output record; 
STM nis the size of the fixed-control area. The 


remaining data in the input record is written into 
the variable portion of the output record. 


If you specify /WF and neither file contains VFC records, RMSCNV 
will terminate with the fatal error message: 


?CNV-F-IWF, Illegal use of /WF with record format 
By default, if you do not specify /WF and one of the files 
contains VFC records, RMSCNV will ignore the fixed-control area 


of each record, processing the records as follows: 


Input Output 


File File Processing 

VEC any Only the variable portion of each record is read 
from the input file and written to the output 
file. 

any VEC Data read from the input file is written only into 


the variable portion of each output record. 


4.4 RMSCNV PROCESSING 


The manner in which RMSCNV reads and writes files depends on the 
organization of the files and on the switches you specify in the 
command string. 


1. The expansions of the record format abbreviations used in the list 
are: variable with fixed control (VFC), fixed (FIX), variable (VAR), 
and stream (STM). 
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4.4.1 Output File Organization and RMSCNV Processing 


4.4.1.1 Sequential Output File Organization - If the output file 
organization is specified as sequential (by default or by using the 
switch /FO:S), and the /AP switch is not specified, RMSCNV will create 
the output file with the attributes of the input file. RMSCNV will 
then read records from the input file and write them sequentially into 
the new output file. 


If the output file already exists, RMSCNV will create the next higher 
version. 


(For information on the /FO and /AP switches, see Section 4.3.) 


If the output file organization is specified as sequential and the /SU 
switch is specified, RMSCNV will supersede an existing file with the 
records of the input file. If the output file does not exist, RMSCNV 
will create one with the attributes of the input file. (For more 
information on the /SU switch, see Section 4.3.) 


If the output file organization is specified as sequential and the /AP 
switch is specified, RMSCNV will append records to an existing file by 
reading records from the input file and writing them sequentially into 
the output file, starting with the record position following the last 
record that is already in the output file. If the output file does 
not exist, RMSCNV will terminate with the fatal error message: 


?CNV-F-ERSFNF, File <file-spec> not found 


(For more information on the /AP switch, see Section 4.3.) 


4.4.1.2 Relative Output File Organization - If the output file 
organization is specified as relative (using the switch /FO:R), RMSCNV 
will read records from the input file and write them into successive 
record cells of the output file, beginning with cell 1. If RMSCNV 
encounters a cell in the output file that already contains a _ record, 
it will terminate with the fatal error message: 


?CNV-F-ERSREX, Relative record already exists for file <file-spec> 


All records written up to that point are still in the file. You 
should examine the input and output files to determine the extent of 
processing. 


If the relative output file does not exist, RMSCNV will terminate with 
the fatal error message: 


?CNV-F-ERSFNF, File <file-spec> not found 


4.4.1.3 Indexed Output File Organization - If the output file 
Organization is specified as indexed (using the switch /FO:1I), RMSCNV 
will read each record from the input file and apply the output file's 
record structure (that is, key placement within the record) to the 
data. This structure is an attribute of the output file and is not 
dependent on input file organization. The record is inserted into the 
output file on the basis of the value in the primary key field. Then, 
RMSCNV will update the output file's primary and (if any) alternate 
indexes to reflect the presence of the new record. 
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If the indexed output file does not exist, RMSCNV will terminate with 
the fatal error message: 


?CNV-F-ERSFNF, File <file-spec> not found 


4.4.2 Input File Organization and RMSCNV Processing 


4.4.2.1 Sequential Input File Organization - If the input file 
organization is sequential, RMSCNV will read the records in sequential 
access mode, starting with the first record in the file. 


4.4.2.2 Relative Input File Organization - If the input file 
Organization is relative, RMSCNV will read the records in sequential 
access mode, starting with record cell l. 


4.4.2.3 Indexed Input File Organization - If the input file 
organization is indexed, RMSCNV will read the records in sequential 
access mode, following the key of reference specified by the /KR or 
/KN switch in the command string (the primary key is the default if 
none is specified). 


If a record in an indexed input file is shorter than the primary key 
of an indexed output file, RMSCNV will terminate with the fatal error 
message: 


?CNV-F-ERSRSZ, Illegal record size specified for file <file-spec> 


Any records processed before the too-short record may or may not have 
been written to the output file, depending on such factors as buffer 
sizes and I/O techniques. You can use the /KR or /KN switch (see 
Section 4.3) to examine the input file at your terminal as follows: 


TI:=INFILE.IDX/KR:1 or TI:=INFILE,. IDX/KN: NAME 


4.5 RMSCNV EXAMPLES 


>DES PAYROL.DES 
>CNV PAYROL.DAT/FO:1/SL=PAYROL.SEQ 
RMS-11 Convert -- Version 2.0 Summary Listing 


Options in effect: 


DBO: [70,5] PAYROL.SEQ;2 
File organization: Sequential 
File attributes: Allocation=31, Extend=0 
Record format: Variable length 
Record attributes: Carriage return 


DBO: [70,5] PAYROL.DAT;2 
File organization: Indexed, using 2 key(s) 
File attributes: Allocation=3, Extend=0, Bucket size = l 
Record format: Variable length 
Record attributes: Carriage return 
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Message summary: 


Processing summary: 
Records read: 448 
Records written: 448 


First, RMSDES is used to create a new indexed file, PAYROL.DAT. Then, 
RMSCNV reads the input records from the input sequential file 
PAYROL.SEQ and writes the records to the PAYROL.DAT file. A summary 
of the RMSCNV operations is printed on the terminal. 


>CNV STAT.DAT/AP=STAT. INP 


RMSCNV appends the records from the input file, STAT.INP, to the 
output (sequential) file, STAT.DAT. 


>CNV EMPLY.DAT/FO: REL/TR/WF=EMPLY. INP 


RMSCNV reads each record of the input file, EMPLY.INP, and writes the 
records to the output file, EMPLY.DAT, which is a relative file with 
VFC format records. As each record is written, the first bytes of the 
input record become the fixed-control area of the output record. 
Since the maximum record size of the output file is 80 bytes, and the 
input file record size is 132 bytes, trailing bytes are discarded. 


>CNV ACCNT.DAT/FO: IDX/TR/PD: *=ACCNT. INP 


RMSCNV reads each record of the input file and writes the record to 
the indexed output file. The input file has variable length records 
and the output file has fixed length records. If necessary, RMSCNV 
truncates input records or pads them with the character "*", 


>CNV VHC.KRO/CA/SL=VHC. INX/KR:0 
RMS-11 Convert -- Version 2.0 Summary Listing 


Options in effect: 
Create copying attribute data (CA) 
Select key by number (KR) 


DBO: [70,5] VHC. INX;7 
File organization: Indexed, using 2 key(s) 


File attributes: Allocation=62, Extend=l, Bucket size = 4 
Record format: Fixed length 80 byte records 
Record attributes: Carriage return 
DBO: [70,5] VHC.KRO;1 
File organization: Indexed, using 2 key(s) 
File attributes: Allocation=40, Extend=l1, Bucket size = 4 


Record format: Fixed length 80 byte records 
Record attributes: Carriage return 


Message summary: 
S$CNV-I-IKY, Input key of reference is #0 (NPANXX) 


Processing summary: 
Records read: ll 
Records written: ll 
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VHC.KRO, with the input file's 
the records from the indexed input 


output file, 
RMSCNY reads 


creates an 
Then, 


“RMSCNV 
attributes. 


file, based on the primary key. RMSCNV lists a summary of its 
operations on the terminal. 

>CNV VHC.KR1/CA/SL=VHC.INX/KR:1 

RMS-11 Convert -- Version 2.0 Summary Listing 


Options in effect: 
Create copying attribute data (CA) 
Select key by number (KR) 


DBO: [70,5] VHC. INX;7 
File organization: Indexed, using 2 key(s) 


File attributes: Allocation=62, Extend=1, Bucket size = 4 
Record format: Fixed length 80 byte records 
Record attributes: Carriage return 
DBO: [70,5] VHC.KR1;1 
File organization: Indexed, using 2 key(s) 
File attributes: Allocation=40, Extend=1, Bucket size = 4 
Record format: Fixed length 80 byte records 
Record attributes: Carriage return 
Message summary: 
$CNV-I-IKY, Input key of reference is #1 (PLACE) 
Processing summary: 
Records read: 11 
Records written: ll 
RMSCNV creates an output file, VHC.KR1, with the input file's 
attributes. Then, RMSCNV reads the records from the indexed input 


file, based on the first alternate key. 
operations on the terminal. 


RMSCNV lists a summary of its 


>CNV TI:=VHC.KRO 


0505801480 10060000201221 005415 070BERNARDSVLNJ060481 00 
0507301348 00060000201222 002885 0 70LONGBRANCHNJ071578 00 
0511101332 10060000201223 002885 O70MANASQUAN NJO11582 00 
0498201417 00060000201224 006882 O7O0CLIFFSIDE NJ060581 00 
0506901429 00060000201225 002885 O7OMETUCHEN NJ060481 00 
0500701457 00060000201226 005613 O70CALDWELL NJ111881 00 
0500701457 00060000201227 005613 O70CALDWELL NJ111881 00 
0500701457 00060000201228 005613 O70CALDWELL NJ111881 00 
0507301348 00060000201229 002885 070LONGBRANCHNJ071578 00 
0508901466 10060000201231 005643 070SOMERVILLENJ100679 00 
0504801441 00060000201232 005613 O7OWESTFIELD NJ111881 00 
In this example, RMSCNV reads the contents of the input indexed file 


and writes the records to the current TI: 


assignment. 


>CNV CUST.FIL/CA/SL=NODA"SMITH XUK9"::[70,5]CUST.DAT 


RMS-11 Convert -- Version 2.0 Summary Listing 
Options in effect: 

Men er bA ARAKI na hear het Anke SOXAN 

VLeace CVpy aly CLIiVULoeE UALA (or) 
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NODA"SMITH XUK9"::DB0:[70,5]1CUST.DAT;1 
File organization: Sequential 
File attributes: Allocation=20, Extend=0 
Record format: Variable length 
Record attributes: Carriage return 


DBO: [70,5]CUST.FIL;1 
File organization: Sequential 
File attributes: Allocation=20, Extend=0 
Record format: Variable length 
Record attributes: Carriage return 


Message summary: 


Processing summary: 
Records read: 124 
Records written: 124 


RMSCNV creates an output file, CUST.FIL, from the attributes of the 
output file. The output file, CUST.DAT, is on a remote node, NODA. 
Each record is read from the output file and written to the input 
file, and a summary of the operations is displayed on the terminal. 


CHAPTER 5 


RMS-11 FILE DISPLAY UTILITY: RMSDSP 


The RMS-11 File Display Utility (RMSDSP) displays a concise 
description of any RMS-11 file, including container files. A 
container file is a magnetic tape file that contains RMS-1ll files that 
were backed up using RMSBCK (see Chapter 6). 

You can use RMSDSP to display a file's attributes so vou can create a 
file like it using RMSDES, or to determine what kind of file your 
high-level language task created so you can match and/or enhance it 
uSing RMSDES. (See Chapter 2 for information on RMSDES.) 


The basic display that RMSDSP produces for disk sequential, relative, 
and indexed files includes: 


e A complete file specification 

@e Prologue version (for relative and indexed files) 
e File size 

e File owner 

e File identification 

e Creation and revision dates 

e File protection 


e File organization, including numbers of keys and areas for 
indexed files 


e File attributes 
@e Record format 
@e Record attributes 


The basic display that RMSDSP produces for magnetic tape files 


includes: 
@e A complete file specification 
e File organization 
e File attributes 


@e Record format 


e Record attributes 
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The basic display that RMSDSP produces for RMSBCK back-up files (on 
disk or on magnetic tape) includes: 

@e A complete file specification 

e File size 


@® Creation date 


In addition, for indexed files and back-up files, you can request a 
more detailed display (see Section 5.3). For indexed files, RMSDSP 
also displays information on areas, primary and alternate keys, and 
allocation. 


For back-up files, the detailed display includes file protection, file 
organization, record format, contiguity, and whether the version 
number is octal (for files created on RSX-11M/M-PLUS systems) or 
decimal (for files created on VAX/VMS systems). 


Although RMSDSP does not display allocation information for magnetic 
tape files, you can display this information by using the Peripheral 
Interchange Program (PIP; see the RSX-11M/M-PLUS Utilities Manual). 


The following sections describe how to invoke and terminate RMSDSP 
(Section 5.1) and the RMSDSP command string and switches (Sections 5.2 
and 5.3). Section 5.4 provides examples illustrating the RMSDSP 
displays. Appendix C documents messages. 


5.1 INVOKING AND TERMINATING RMSDSP 


The RMSDSP utility can be either installed or uninstalled. If RMSDSP 
is installed, invoke it with the command: 


DSP [command-string] 


Tf you include a command strin 
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If you do not include a command string, RMSDSP will prompt for one: 
DSP> 


If RMSDSP is uninstalled on RSX-11M/M-PLUS systems, invoke it with the 
command: 


RUN SRMSDSP 
RMSDSP will respond with the prompt: 
DSP> 


In response to the prompt, you can type a command string or you can 
type CTRL/Z to terminate the utility. When RMSDSP has executed a 
command string, it returns the DSP> prompt. Section 5.2 describes the 
RMSDSP command string. 


Indirect Command Files. You can execute series of RMSDSP command 
strings by means of indirect command files. The command strings in an 
indirect command file are executed when an at sign (@) followed by the 
file's name is specified to the utility. The default file type of 
-CMD is assumed if none is provided. 


RMS-11 FILE DISPLAY UTILITY: RMSDSP 


Installed RMSDSP will accept indirect command files either from the 
system prompt or from the utility prompt. For example, to execute the 
command strings contained in the indirect command file DSPCOM.CMD, you 
could type either of the following commands: 


DSP> @DSPCOM 


Uninstalled RMSDSP will accept indirect command files only from the 
utility prompt. For example: 


DSP> @DSPCOM 


If you executed the indirect command file from the system prompt, the 
system prompt will be returned. If you executed the indirect command 
file from within RMSDSP, the DSP> prompt will be returned. 


5.2 RMSDSP COMMAND STRING 

Format 
foutfile=]infile[/switch...][{,infile[/switch...]...] 

outfile 


The specification of a file that RMSDSP creates to write the 
attributes or list the contents of the specified input file(s). 
Wild card characters are not permitted in any field of the 
specification. The default version is the highest existing 
version number plus l. 


By default, if you do not specify an output file, RMSDSP will 
display the information on your terminal. 


infile 


The file specification of any RMS-11 file whose attributes you 
want displayed or a container file whose contents you want 
listed. For container files, you must specify the /BP switch 
(see Section 5.3). Wild card characters (*) are permitted in any 
field of the specification. 


RMSDSP requires ANSI-standard labels on magnetic tapes. You must 
mount a tape volume to inform your operating system's file 
processor that you are accessing an ANSI-standard tape. 


See the RSX-11M/M-PLUS RMS-11l User's Guide for more information 
on RMS-11 magnetic tape handling. 

If you do not mount your tape volume, RMSDSP will not accept wild 
card characters in the specification and will respond to an 
explicit file name with the tape device's attributes. 


/switch 


One of the switches listed in Table 5-1 and described in Section 
Bie Sa All switches are global; that is, they can be specified 
anywhere in the command string. 


In place of the command string you can type HELP or ? to display help 
text about RMSDSP, or /ID to display the current version of the 
utility. 
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Table 5-1: RMSDSP Switches 


Switch Description 


/BP List contents of back-up file(s) 


Default: Provide basic display only 


/FU Provide detailed display for indexed 
files or back-up files 


Default: Provide basic display only 


/ID Identify current version 


Default: No identification 
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/BP 


/FU 


RMSDSP SWITCHES 


Directs RMSDSP to read the specified input files as RMSBCK 
back-up files (see the description of the RMSBCK utility, Chapter 
6) and to display the names, sizes, and creation dates of the 
RMS-11 files backed up to tape or disk (see Example 5-6 in 
Section 5.4). 


If you specify /BP with both back-up and non-back-up files, 
RMSDSP will provide displays for the back-up files only. It will 
ignore the non-back-up files. 


By default, if you do not specify /BP, RMSDSP will provide the 
basic display for disk or magnetic tape files: file organization 
and attributes, and record format and attributes (see Example 5-5 
in Section 5.4). 


Directs RMSDSP to provide the detailed display for either an 
indexed file or a back-up file (when used with /BP). 


If you specify /FU with an indexed file, the display will include 
information on the individual keys and areas, and on allocation 
(see Example 5-4 in Section 5.4). 


If you specify /FU with /BP for a back-up file, the display will 
include information on the owner, protection, file organization, 
record format, whether the file is contiguous, and whether the 
version number is octal (for a file created on an RSX-11M/M-PLUS 
system) or decimal (for a file created on a VAX/VMS system). See 
also Example 5-7 in Section 5.4. 


Knowing whether the version number is octal or decimal is useful 
in transferring RMS-1] files among operating systems using RMSRST 
(see Chapter 7). If the file is displayed with no version 
number, it was created and backed up on a RSTS/E system. 
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Under RSTS/E systems, the decimal project-programmer number (PPN) 
fields are the reverse of the octal User Identification Code 
(UIC) fields under VAX/VMS and RSX-11M/M-PLUS. Thus, in the 
owner's field of the display for files created under RSTS/E, the 
PPN fields will be reversed and shown in their octal equivalents. 


By default, if you do not specify /FU, RMSDSP will provide the 
basic displays for indexed files (see Example 5-3 in Section 5.4) 
and container files (see Example 5-6 in Section 5.4). 

/1ID 
Displays the current version of the RMSDSP utility. For example: 


DSP>OUTFIL.DAT/ID=INFILE.DAT 
$DSP-I-ID, Version 2.000 


The last two digits of the version number (00 in this’ example) 
are the patch level of the utility. The /ID switch can also be 
specified by itself on the command line: 


DSP>/ID 
$DSP-I-ID, Version 2.000 


5.4 RMSDSP DISPLAYS 


Examples 5-1 through 5-8 illustrate the RMSDSP display formats. 


NOTE 
The File ID field of the displays for 
disk sequential, relative, and indexed 


files is in octal for RSX-11M/M-PLUS 
systems. 


Example 5-1: RMSDSP Display Format for Disk Sequential Files 


>DSP PAYROL.SEQ 


DBO: [70,5] PAYROL.SEQ; 2 


Size: 31./31. Created: 1-APR-1983 05:45 
Owner: [070,005] Revised: 1-APR-1983 14:11 (3) 
File ID: (11766,3,0) 

File protection: System:RWED, Owner:RWED, Group:RWED, World:R 

File organization: Sequential 

File attributes: Allocation=31, Extend=0 

Record format: Variable length, no maximum defined 

Record attributes: Carriage return 
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Example 5-2: RMSDSP Display Format for Relative Files 


>DSP EMPLY.DAT 


SY: [070,005] EMPLY.DAT;1 RMS Prologue Version=l 

Size: 30./30. Created: 2-APR-1983 01:43 
Owner: [070,005] Revised: 2-APR-1983 01:45 (2) 
File ID: (6343,55,0) 

File protection: System:RWED, Owner:RWED, Group:RWED, World:R 

File organization: Relative, no maximum record number defined 

File attributes: Allocation=30, Extend=0, Bucket size=2 

Record format: VFC, 2 byte header, maximum 80 bytes 

Record attributes: Carriage return 


Example 5-3: RMSDSP Display Format for Indexed Files 


>DSP PAYROL.DAT 


DBO: [70,5] PAYROL.DAT;2 RMS Prologue Version=1l 

Size: 63./63. Created: 2-APR-1983 01:44 
Owner: [070,005] Revised: 2-APR-1983 01:47 (2) 
File ID: (27743,10,0) 

File protection: System:RWED, Owner:RWED, Group:RWED, World:R 

File organization: Indexed, using 2 key(s) with 1 area(s) 

File attributes: Allocation=63, Extend=0, Bucket size=1 

Record format: Variable length, no maximum defined 

Record attributes: Carriage return 


Example 5-4: RMSDSP Display Format for Indexed Files 
(with /FU Specified) 


>DSP PAYROL.DAT/FU 


DBO: [70,5] PAYROL.DAT; 2 RMS Prologue Version=1l 

Size: 63./63. Created: 2-APR-1983 01:44 
Owner: {070,005} Revised: 2-APR-1983 01:47 (2) 
File ID: (27743,10,0) 

File protection: System:RWED, Owner:RWED, Group:RWED, World:R 

File organization: Indexed, using 2 key(s) with 1 area(s) 

File attributes: Allocation=63, Extend=0, Bucket size=1 

Record format: Variable length, no maximum defined 

Record attributes: Carriage return 


Area number Q: 
Bucket size=1 
Allocation remaining=1, Extend=0 


Primary key: 
Name=<not specified>, Minimum record length=12 
Key information: 
Type=String, Length=12, Duplicates, No changes 
Position(s) and size(s): 
Segment=0, position=0, length=12 
Area information: 
Index: Area number=0 
Lowest level area=0 
Bucket size=1l, Fill factor=512 
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Example 5-4 (Cont.): RMSDSP Display Format for Indexed Files 
(with /FU Specified) 


Data: Area number=0 
Bucket size=1, Fill factor=512 
Ailocation information: 
Root virtual block number=4, Root level=1 
First data bucket virtual block number=5 


Alternate key number 1: 
Name=<not specified>, Minimum record length=17 
Key information: 
Type=String, Length=17, Duplicates, Changeable 
Position(s) and size(s): 
Segment=0, position=0, length=17 
Area information: 
Index: Area number=0 
Lowest level area=0 
Bucket size=1, Fill factor=512 
Data: Area number=0 
Bucket size=1, Fill factor=512 
Allocation information: 
Root virtual block number=7, Root level=1 
First data bucket virtual block number=8 


Example 5-5: RMSDSP Display Format for Magnetic Tape Files 


>DSP MMOs #5. 3% 


MMO: PAYROL.CON;1 


File organization: Sequential 

File attributes: Magnetic tape, Block size=2064 
Record format: Undefined 7 

Record attributes: None 


MMO :MASTER.BCK;1 


File organization: Sequential 

File attributes: Magnetic tape, Block size=2064 
Record format: Undefined - 

Record attributes: None 


Example 5-6: RMSDSP Display for Back-Up Files 


>DSP MMO:*.*;*/BP 


Contents of container file MMO:MASTER.BCK;1 


[070,005] PAYROL.DAT;2 63./63. 2-APR-1983 01:44 
[070,005]STAT.DAT;1 20./20. 2-APR-1983 01:43 
[070,005] EMPLY.DAT;1 30./306. 2-APR-1983 01:43 
{070,005} ACCNT.DAT;1 30./30. 2-APR-1983 01:43 


Contents of container file MM0O:PAYROL.CON;1 


[070,005] PAYROL.DAT;2 634,/63% 2-APR-1983 01:44 
[070,005] PAYROL.LOG;1 294./294. 1-APR-1983 05:45 
[070,005] PAYROL.DES;2 4./4. 14-JAN-1983 08:36 
[070,005] PAYROL.SEQ;2 31./31. 1-APR-1983 05:45 
[070,005] PAYROL.MST;1 3/3 14-JAN-1983 08:43 
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- Example 5-7: 


>DSP MM1:*.*/BP/FU 


Contents of container 


RMSDSP Display Format for Back-Up Files 
(with /FU Specified) 


file: MM1l:RSX1L1M.CON;1 


[100,101] HART.SEQ;1 ; 0./0. 15-JAN-1982 14:06 
[100,101] [RWED, RWED,RWED,R] 15-~JAN-1982 14:06 
Organization=Sequential, Record format=Variable 
Not contiguous, Version number=Octal 

{100,101]HOGAN.REL;1 heey oo as 15-JAN-1982 14:06 
[100,101] [RWED, RWED, RWED,R] 15~JAN-1982 14:06 
Organization=Relative, Record format=Fixed 
Not contiguous, Version number=Octal 

[100,101] SIEMBO. IDX;1 iz 100./200. 15-JAN-1982 14:12 
[100,101] {RWED, RWED, RWED, R] 15-JAN-1982 14:12 
Organization=Indexed, Record format=Fixed 
Not contiguous, Version number=Octal 

{100,101] RMSDSP.TSK;11 =. 162./162. 15-JAN-1982 14:12 
{100,101] [RWED, RWED, RWED, R] 15-JAN-1982 14:12 
Organization=Sequential, Record format=Fixed 
Contiguous, Version number=Octal 

[100,101]DEMO.CMD;1 = Ie go 15-JAN-1982 14:28 
{100,101] [RWED, RWED, RWED, R] 15-JAN-1982 14:28 
Organization=Sequential, Record format=Variable 
Not contiguous, Version number=Octal 

Example 5-8: RMSDSP Display Format Using Wildcard Characters 
>DSP PAYROL.* 
S¥: [070,005] PAYROL.DAT;2 RMS Prologue Version=1 
Size: 63./63. Created: 2-APR-1983 01:44 
Owner: {070,005} Revised: 2-APR-1983 01:47 (2) 
File ib: (27743,10,0) 

File protection: System:RWED, Owner:RWED, Group:RWED, World:R 

File organization: Indexed, using 2 key(s) with 1 area(s) 

File attributes: Allocation=63, Extend=0, Bucket size=l 

Record format: Variable length, no maximum defined 

Record attributes: Carriage return 

SY: [070,005] PAYROL.DES; 2 
Size: 4./4. Created: 14-JAN-1983 08:36 
Owner: [070,005] Revised: 2-APR-1983 01:44 (7) 
File ID: (11342,13,0) 

File protection: System:RWED, Owner:RWED, Group:RWED, World:R 

File organization: Sequential 

File attributes: Allocation=4, Extend=0 

Record format: Variable length, no maximum defined 

Record attributes: Carriage return 

SY: [070,005] PAYROL.SEQ;2 
Size: 31./31. Created: 1-APR-1983 05:45 
Owner: [070,005} Revised: 1-APR-1983 14:11 (3) 


File protection: 
File organization: 
File attributes: 
Record format: 
Record attributes: 


File ID: (11766,3,0) 

System: RWED, Owner:RWED, Group:RWED, World:R 
Sequential 

Alilocation=31, Extend=0 

Variable length, no maximum defined 

Carriage return 
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The RMS-11 File Back-Up Utility (RMSBCK) transfers the contents of any 
RMS-11 disk file to another disk or to a container file. A container 
file is a magnetic tape file that contains RMS-1ll files that were 
backed up using RMSBCK. 


When RMSBCK transfers RMS-11 files, the back-up copy retains the 


source file's attributes: account number, creation and revision 
dates, protection code, contiguity, and so on, with the exception of 
placement. A file cannot be restored to the same physical place on 


the device from which it was backed up. 


The back-up files are specially formatted so that they can be accessed 
only by the RMSRST utility (see Chapter 7); they cannot be read or 
modified by user programs or other utility programs. RMSDSP, however, 
can display information about RMSBCK back-up files (see Chapter 5). 


You can use RMSBCK and RMSRST to protect your data against hardware or 
software failure. When you back up files on a regular basis, files 
lost or damaged can be restored from the back-up copies. 


You can also use RMSBCK and RMSRST to transfer files between different 
operating systems, for example, between RSX-11M/M-PLUS and VAX/VMS, 
and between RSTS/E and RSX-1LIM/M-PLUS or VAX/VMS. See Chapter 7 for 
more information on using RMSRST to restore files to different 
operating systems. 


RMSBCK backs up files to magnetic tape volumes with ANSI-standard 
labels only. However, the back-up data written to the volume by 
RMSBCK need not comply with ANSI standards. 

Note that RMSBCK cannot back up a system disk as a bootable volume. 


RMSBCK provides four processing features: 


@ Explicit and implicit input file selection -- You can specify 
one or more input files with or without wild card characters. 


Data integrity checks -- You can check the reliability of the 
backed up data files. 


@ Extended diagnostic messages -- Query mode gives you the 
option of continuing processing if RMSBCK encounters an error 
condition. 


e Summary listing -- You can create a record of RMSBCK 
processing. 


Section 6.4 describes these processing features in greater detail. 
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“The following sections describe how to invoke and terminate RMSBCK 

(Section 6.1) and the RMSBCK command string and switches (Sections 6.2 
and 6.3). Section 6.5 provides examples illustrating the use of 
RMSBCK. Appendix C documents messages. 


6.1 INVOKING AND TERMINATING RMSBCK 


The RMSBCK utility can be either installed or uninstalled. If RMSBCK 
is installed, invoke it with the command: 


BCK [command-string] 


If you include a command string, RMSBCK will execute the command and 
return the system prompt. 


If you do not include a command string, RMSBCK will prompt for one: 
BCK> 


If RMSBCK is uninstalled on RSX-11M/M-PLUS systems, invoke it with the 
MCR command: 


RUN SRMSBCK 
RMSBCK will respond with the prompt: 
BCK> 


In response to the prompt, you can type a command string or you can 
type CTRL/Z to terminate the utility. When RMSBCK has executed a 
command string, it returns the BCK> prompt. Section 6.2 describes the 
RMSBCK command string. 


Indirect Command Files. You can execute series of RMSBCK command 
strings by means of indirect command files. The command strings in an 
indirect command file are executed when an at sian (@) followed by the 
file's name is specified to the utility. The default file type of 
-CMD is assumed if none is provided. 


Installed RMSBCK will accept indirect command files either from the 
system prompt or from the utility prompt. For example, to execute the 
command strings contained in the indirect command file BCKCOM.CMD, you 
could type either of the following commands: 


BCK @BCKCOM 
or 
BCK> @BCKCOM 


Uninstalled RMSBCK will accept indirect command files only from the 
utility prompt. For example: 


BCK> @BCKCOM 
If you executed the indirect command file from the system prompt, the 


system prompt will be returned. If you executed the indirect command 
file from within RMSBCK, the BCK> prompt will be returned. 
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6.2 RMSBCK COMMAND STRING 


Before you issue a command string to RMSBCK, the back-up medium (disk 
or ANSI-labeled magnetic tape) must be online and mounted. 


Format 
outfile[{/switch...]=infile[/switch...][,infile[/switch...]...] 
outfile 


The specification of a disk or magnetic tape file to be created 
by RMSBCK. If the back-up medium is disk, both the file name and 
type must be wild card characters (*.*). The file names and 
types of the container files will be the same as the associated 
input data files. You can omit the version; RMSBCK will use the 
version of the associated input file. 


If you do not use wild card characters in specifying the output 
file, RMSBCK will terminate with the error message: 


%BCK-W-NRN, No rename allowed 


If the back-up medium is magnetic tape, multiple input files will 
be backed up in a single container file. You must explicitly 
name the output container file in the command string, but’ the 
name need not correspond to the name of any input file. You can 
omit the version; a value of 0 will be used. If you do not 
explicitly name the container file, RMSBCK will terminate with 
the fatal error message: 


SBCK-W-NDM, Explicit container filename necessary 


RMSBCK does not prevent you from putting multiple container files 
with the same file specification on the same magnetic tape 
volume. Therefore, you should specify unique file names, types, 
and versions for output container files written to the same 
volume. (You can use RMSDSP to display information about back-up 
files; see Chapter 5.) 


infile 


The specification of a disk file from which a back-up copy is to 
be created. You can use wild card characters (*) to implicitly 
specify a collection of files. 


If you specify a nondisk device, RMSBCK will terminate with the 
fatal error message: 


?BCK-F-ERSDEV, Bad or inappropriate device type for file <device> 
<device> is the device name and unit you specified. 


If you specify a file that is listed in several accounts by 
means, for example, of the PIP/ENTER command (see _ the 
RSX-1LIM/M-PLUS Utilities Manual), RMSBCK will copy the entire 
file even though it exists in another account. However, when you 
restore the file with RMSRST, the link to the other accounts will 
be broken. 
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For example, you have a file of names, ACCTSRECV.DAT, stored in 
account [30,1] which is pointed to by the directory entry 
[10,l1JCLIENTS.DAT (by means of the PIP/ENTER command). If you 
back up [10,1]CLIENTS.DAT, RMSBCK will copy the file from 
[30,1]ACCTSRECV.DAT. When you restore the file, RMSRST will 
write the file into account [10,1]. The restored file will no 
longer be linked with the file of names in  [30,1]ACCTSRECV.DAT; 
rather, it will be a duplicate of that file. 
/switch 


One of the switches listed in Table 6-1 and described in Section 
6.3. 


In place of the command string, you can type HELP or ? to display 


help text about RMSBCK, or /ID to display the current version of the 
utility. 


Table 6-1: RMSBCK Switches 
Type Switch Description 


Global /ID Identify current version 
Default: No identification 
/ [NO] QU Enable or disable query mode 
Default: Enable query mode 


/SL[:file-spec] Provide summary listing (in file, if 
specified) 


Default: No summary 


Output /RA Read-after-writing data integrity 
File checking 


Default: No reading 


/RC Check-after-writing data integrity 
checking 


Default: No checking 
/ RW Rewind magnetic tape before writing 
Default: No rewinding 
/SU Supersede existing file 
Default: No supersession 
Input /CD:dd-mmm-yy[:v] Back up files based on creation date 
ae Default: No date checking 


/RD:dd-mmm-yy[:v] Back up files based on revision date 


Default: No date checking 
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6.3 RMSBCK SWITCHES 
This section describes the global, output file, and input file 
Switches that you can specify in RMSBCK command strings. Global 


Switches are switches that can be specified anywhere in the command 
strina. 


6.3.1 Global Switches 


The global switches are /ID, /QU, and /SL. 


/ID 
Displays the current version of the RMSBCK utility. For example: 
BCK>OUTFIL.DAT/ID=INFILE.DAT 
$BCK-I-ID, Version 2.000 
The last two digits of the version (00 in this example) are _ the 
patch level of the utility. The /ID switch can also be specified 
by itself on the command line: 
BCK>/ID 
%BCK-I-ID, Version 2.000 
/ {NO] QU 


Enables or disables query mode. If you specify /QU, RMSBCK will 
allow you to chose to continue or to terminate processing when 
one of the following occurs: 


e A read error occurs on an input file. 


e A read-after-write error occurs on an output file when the /RA 
Switch is specified (see Section 6.3.2). 


e A read-after-write error occurs on an output file when the /RC 
switch is specified (see Section 6.3.2). 


e The table allocated internally for data integrity checks or 
for automatic retry of read errors is full. 


When one of these errors occurs, RMSBCK prints a diagnostic 
message specifying the type of error and the name of the file 
being processed. It also prompts you, asking whether you want to 
continue processing. If you answer Y, RMSBCK will continue 
processing the current file and command string. If you answer N, 
RMSBCK will terminate processing immediately, without processing 
the rest of the command string. 


‘e 1 
or Skampic: 


BCK>OUTFIL., DAT /QU=INFILE. DAT 

?BCK-F-WCE, Check after write error on output file <file-spec> 
VBN 1 to 2. Continue (Yes or No)? Y 

?BCK-F-TER, Integrity check table full. Continue (Yes or No)? N 


You can disable query mode with the /NOQU switch. RMSBCK will 
print a diagnostic message when it encounters an error and 
terminate processing. 


By default, if you do not specify /QU or /NOQU, query mode will 
be enabled. 
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/SL[:£ile-spec] 


6.3.2 


Directs RMSBCK to produce a summary of file back-up processing. 
The summary listing consists of: 


e The command string 
e The names of files successfully backed up 


e The names of files that were not backed up, with associated 
error messages 


e The diagnostic messages produced in query mode (if query mode 
was enabled) 


e A summary of any input errors and a summary of any errors 
remaining in output back-up files after automatic retry of 
data integrity checks (if you specified /RA or /RC) 


If you specify a file as an argument to /SL, and a file of the 
same name and type already exists, RMSBCK will append the summary 
to that file. You can thus use one file to keep a record of all 
file conversions. 


If you specify a file, and a file of the same name and type does 
not exist, RMSBCK will create a new file and write the summary to 
that file. 


If you do not specify a file, the summary will be written to your 
terminal. 


Do not specify either the input file or the output file as_ the 
argument to /SL. 


By default, if you do not specify /SL, RMSBCK will write messages 
to your terminal if it encounters errors (see Appendix C). 


Output File Switches 


The output file switches are /RA, /RC, /RW, and /SU. 


/RA 


Directs RMSBCK to read the back-up file after writing it. RMSBCK 
reads back each block of the back-up file. If the device 
hardware detects a read error, RMSBCK will respond according to 
whether query mode is enabled (see the description of the /[NO]QU 
switch in Section 6.3.1). 


Note that you cannot specify /RA and /RC in the same command 
String. RMSBCK terminates with the fatal error message: 


?BCK-F-CSW, Conflicting switch specified - /sw 


The value /sw is /RA or /RC depending on which appears second in 
the command string. 


By default, if you do not specify /RA, RMSBCK will not perform 
read-after-writing data integrity checking. 


/ RC 


/RW 


/SU 
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Directs RMSBCK to check the back-up file after writing it. After 
the file has been completely backed up, RMSBCK reads it back into 
memory, block by block. At the same time, it reads the input 
file back into memory, block by block. RMSBCK compares the 
corresponding blocks as it reads them. If an error occurs during 
the comparison (a hardware read error or a mismatch between the 
contents of the two blocks), RMSBCK will respond according to 
whether query mode is enabled (see the description of the /[NO]QU 
switch in Section 6.3.1). 


Note that you cannot specify /RC and /RA in the same command 
string. RMSBCK terminates with the fatal error message: 


?BCK-F-CSW, Conflicting switch specified - /sw 


The value /sw is /RA or /RC depending on which appears second in 
the command string. 


By default, if you do not specify /RC, RMSBCK will not perform 
check-after-writing data integrity checking. 


Directs RMSBCK to rewind a magnetic tape before writing a 
container file to it. Rewinding logically deletes any existing 
files on the tape. 


This switch can be specified only if the back-up medium is a 
Magnetic tape. If the back-up medium is a disk and you specify 
/RW, RMSBCK will terminate with the fatal error message: 


?BCK-F-LSW, Illogical switch in context of command - /RW 


By default, if you do not specify /RW, RMSBCK will add a new 
container file to the logical end of the magnetic tape. 


Directs RMSBCK to supersede an existing disk output file with 
records of the input file. RMSBCK does not create a new version 
of the output file: it deletes the existing file, creates one of 
the same name, type, and version, and writes the records of the 
input file to it. 


This switch can be specified only if the back-up medium is a 
disk. If the back-up medium is a magnetic tape and you specify 
/SU, RMSBCK will terminate with the fatal error message: 


?BCK-F-LSW, Illogical switch in context of command - /SU 


/SU, RMSBCK will not supersede 
the files on the output device. If RMSBCK encounters a file with 
the same file name, type, and version as an input file, it will 
print the following error message and continue processing: 


ww ewe 


?BCK-F-ERSFEX, File <file-spec> already exists 
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6.3.3 Input File Switches 
The input file switches are /CD and /RD. 
/CD:dd-mmm-yy [:v] 


Directs RMSBCK to back up files based on their creation date. If 
you use wild card characters in the input file specification, you 
can identify a group of files, depending on the value of the 
argumentv. If you do not specify v, RMSBCK will back up all 
files that satisfy the wild card specification and were created 
on ths date specified. If you specify the value A for the 
argument v, RMSBCK will back up all files that satisfy the wild 
card specification and were created after the date specified. If 
you specify the value B for v, RMSBCK will back up all files that 
Satisfy che wild card specification and were created before the 
date specified. 


If a file has no or a null creation date, RMSBCK will treat it as 
though it had been created before January 1900. 


By default, if you do not specify /CD, RMSBCK will back up all 
files that satisfy the input file specification (unless you 
specified /RD; see the description of the /RD switch in this 
section). 


/RD:dd-mmm-yy [:v] 


Directs RMSBCK to back up files based on their revision dates, 
that is, the dates they were last accessed for writing. If you 
use wild card characters in the input file specification, you can 
identify a group of files, depending on the value of the argument 
v. If you do not specify v, RMSBCK will back up all files that 
satisfy the wild card specification and were revised on the date 
specified. If you specify the value A for the argument v, RMSBCK 
will back up all files that satisfy the wild card specification 
and were revised after the date specified. If you specify the 
value B for v,; RMSBCK will back up all files that satisfy the 
wild card specification and were revised before the date 
specified. 


If a file has no or a null revision date, RMSBCK will treat it as 
though it had been revised before January 1900. 


By default, if you do not specify /RD, RMSBCK will back up all 
files that satisfy the input file specification (unless you 
specified /CD; see the description of the /CD switch in this 
section). 


6.4 RMSBCK PROCESSING 


RMSBCK copies standard RMS-11 data files from one medium to another 
(disk to disk or disk to magnetic tape) so that, if the original data 
files are lost or damaged, you have the back-up copies from which you 
can restore the original data. 


You must use ANSI-labeled magnetic tapes if the back-up medium is 
magnetic tape. However, the back-up data written to the tape need not 
comply with ANSI standards. RMSBCK translates the data into a special 
format; back-up files can be accessed properly only by RMSRST (see 
Chapter 7). User and other utility programs, therefore, cannot read 
or modify back-up data. 
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When the back-up medium is magnetic tape, RMSBCK uses 2064-character 
blocks (representing 16 bytes of container file overhead and 4 disk 
blocks as a record to the container file). You cannot alter the block 
size used by RMSBCK. 


You can use multivolume magnetic tapes; this capability is 
implemented by means of the magnetic tape ancillary control process 
(ACP) interface. 


NOTE 


For multivolume backup sets, the /RA and 
/RC switches will not function properly 
since tape positioning cannot be 
accomplished on those files which span 
tape volumes. 


RMSBCK handles unused blocks in a file according to file organization: 


e If the file is sequential or relative, RMSBCK will not copy 
the unused blocks. 


e If the file is indexed, RMSBCK will copy the unused blocks. 


RMSBCK provides four processing features, as described in the. 
following sections. 


6.4.1 Explicit and Implicit Input File Specification 


The RMSBCK command string allows you to specify input files either 
explicitly or implicitly. File specifications with wild card 
characters (*) implicitly identify a collection of files. When you 
use wild card characters, you can restrict the number of files 
selected for processing by including one of the date switches, /CD or 
/RD (see Section 6.3.3). A date switch directs RMSBCK to examine 
either the creation or the revision date of each file selected as a 
result of the wild card specification: RMSBCK will back up a file 
only if its creation or revision date matches the date specified with 
the switch. 


6.4.2 Data Integrity Checking 


You can direct RMSBCK to check data integrity as each file is created. 
If you specify the /RA output file switch, RMSBCK will read back the 
file contents after they are written to the back-up file. If you 
specify the /RC output file switch, RMSBCK will read back, block by 
block, the contents of the output (back-up) file and the contents of 


the original file and compare them. RMSBCK automatically retries read 
errors if processing continues to normal termination. 
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Thus, you have three choices in data integrity checking: 


e You can specify neither /RA nor /RC and rely on software and 
hardware accuracy, backing up your files in minimum time. 


@e You can specify /RA and verify that the files can be read from 
the back-up medium, adding reading time to the minimum time. 


@e You can specify /RC and verify that the back-up files can be 
read and that they exactly match the original input files, 
adding reading and comparison times to the minimum time. 


See Section 6.3.2 for descriptions of the /RA and /RC switches. 


6.4.3 Extended Diagnostic Messages 


Query mode allows you to specify that processing continues or 
terminates when RMSBCK encounters an error condition. By default, 
query mode is enabled. When RMSBCK encounters an error, it issues a 
diagnostic message to your terminal and prompts you: 


Continue (Yes or No)? 


Depending on your response, RMSBCK continues or terminates processing. 
With this feature, you can ensure that RMSBCK does not terminate 


processing of a group of files if errors are encountered in only one 
file, 


You can disable query mode with the /NOQU output file switch. Le 
RMSBCK encounters an error, it will issue a diagnostic message to your 
terminal and terminate processing automatically. 


See Section 6.3.1 for a description of the /[NO]QU switch. 


6.4.4 Summary Listing 


You can use the /SL switch to produce a summary listing of RMSBCK 
processing, including data integrity checks and error messages. 
RMSBCK will either write the summary to your terminal or into a file 
that you specify, creating a permanent record of the back-up 
processing. 


See the description of the /SL switch in Section 6.3.1, and the 
example summary listing in Section 6.5. 


6.5 RMSBCK EXAMPLES 


>MOU MMO: PAYROL 

>BCK MMO: PAYROL.CON=PAYROL.*/QU/SL 

$BCK-I-FPC, Processing complete for file SY:[070,005] PAYROL.DAT;2 
%$BCK-I-FPC, Processing complete for file SY:[{070,005} PAYROL.LOG;1 
$BCK-I-FPC, Processing complete for file SY:[{070,005] PAYROL.DES;2 
S$BCK-I-FPC, Processing complete for file SY:[070,005] PAYROL.SEQ;2 
S@BCK-I-FPC, Processing complete for file SY:[070,005] PAYROL.MST;1 
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RMSBCK backs up, on ANSI-labeled magnetic tape, all PAYROL files in 
the default account on SY:, into a container file named PAYROL.CON. 


Query mode is explicitly enabled; therefore, any error condition 
causes RMSBCK to issue a diagnostic message and query the user as to 
whether processing should continue. While RMSBCK processes the input 
files, it writes a summary to the terminal. 


>BCK MMO :MASTER.BCK=*.DAT/CD: 30-MAR-83:A/SL:BACKUP.LST 


RMSBCK backs up, on ANSI-labeled magnetic tape, all files in the 
default account on SY: that were created after March 30, 1983 and 
have a file type of .DAT. 


Query mode is enabled by default; therefore, any error condition 
causes RMSBCK to issue a diagnostic message and query the user as to 
whether processing should continue. RMSBCK also creates a summary 
listing file named BACKUP.LST in the default account on SY:. The file 
contains a listing of the files processed and the diagnostic messages 
and queries (and responses) that occurred during processing. 


>BCK DBO: [70,1]*.*;*/SU=DB0: [70,10]*.*;*/RD:01-APR-83 :B/NOQU 


RMSBCK backs up all files in account [70,10] on DBO: that were 
revised before April 1, 1983. The back-up copies are written into 
account [70,1] on the same disk (DB0:), superseding files with the 
same file names and types. 


Query mode is disabled; therefore, if RMSBCK encounters an error, it 
will issue a diagnostic message and terminate processing. 


Note: Examples 5-5 and 5-6 in the RMSDSP chapter illustrate the 
contents of the tape, after the completion of the above backups. 
Examples showing restores of these files are in the RMSRST chapter. 
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The RMS-11 File Restoration Utility (RMSRST) transfers, to disk, files 
that were backed up on magnetic tape or disk using RMSBCK. The form, 
structure, contents, and attributes (except file placement) of the 
restored files are those of the original files when they were backed 
up. 


File placement will not be restored. A file cannot be restored to the 
same physical place on the device from which it was backed up. 


You can use RMSBCK and RMSRST to protect your data against hardware or 
software failure: files lost or damaged can be restored from back-up 
copies. 


You can also use RMSBCK and RMSRST to transfer files between different 
operating systems, for example, between RSX-11M/M-PLUS and VAX/VMS, 
and between RSTS/E and RSX-11M/M-PLUS or VAX/VMS (see Section 7.4.3). 


Files backed up using RMSBCK can be accessed properly only by RMSRST. 
RMSBCK translates data into a special format that cannot be read or 
modified by user programs or other utility programs. RMSRST 
translates the specially formatted data on the back-up files back into 
standard RMS-1l1 files. See Chapter 6 for information on RMSBCK. 


RMSRST cannot restore a system disk as a bootable medium. 
RMSRST provides six processing features: 


e Explicit and implicit input file selection -- You can specify 
one or more input files with or without wild card characters. 


e Choice of restoration account and/or volume -- You can restore 
files into any account on any disk device to which you have 
access privileges. 


e File transfer to different operating systems -- You can 
restore files created and backed up on one operating system to 
another operating system. 


@ Data integrity checks -- You can check the reliability of the 
restored data files. 


@e Extended diagnostic messages -- Query mode gives you _ the 
option of continuing processing if RMSRST encounters an error 
condition. 


e Summary listing -- You can create a record of RMSRST 
processing. 


Section 7.4 describes these processing features in greater detail. 
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The following sections describe how to invoke and terminate RMSRST 
(Section 7.1) and the RMSRST command string and switches (Sections 7.2 
and 7.3). Section 7.5 provides examples illustrating the use of 
RMSRST. Appendix C documents messages. 


7.1 j$INVOKING AND TERMINATING RMSRST 


The RMSRST utility can be either installed or uninstalled. If RMSRST 
is installed, invoke it with the command: 


RST [command-string] 


If you include a command string, RMSRST will execute the command and 
return the system prompt. 


If you do not include a command string, RMSRST will prompt for one: 
RST> 


If RMSRST is uninstalled on RSX-11M/M-PLUS systems, invoke it with the 
MCR command: 


RUN SRMSRST 
RMSRST will respond with the prompt: 
RST> 


In response to the prompt, you can type a command string or you can 
type cCTRL/Z to terminate the utility. When RMSRST has executed a 
command string, it returns the RST> prompt. Section 7.2 describes the 
RMSRST command string. 


Indirect Command Files. You can execute series of RMSRST command 
strings by means of indirect command files. The command strings in an 
indirect command file are executed when an at sign (@) followed by the 
file's name is specified to the utility. The default file type of 
-CMD is assumed if none is provided. 


Installed RMSRST will accept indirect command files either from the 
system prompt or from the utility prompt. For example, to execute the 
command strings contained in the indirect command file RSTCOM.CMD, you 
could type either of the following commands: 


RST @RSTCOM 


or 
RST> @RSTCOM 


Uninstalled RMSRST will accept indirect command files only from _ the 
utility prompt. For example: 


RST> @RSTCOM 


If you executed the indirect command file from the system prompt, the 
system prompt will be returned. If you executed the indirect command 
file from within RMSRST, the RST> prompt will be returned. 
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7.2 RMSRST COMMAND STRING 

Format 
outfile[/switch...J=infile[/switch...][,infile[/switch...]...] 

outfile 


The specification of a disk file to which back-up files are to be 
restored by RMSRST. The file name and type must be wild card 
characters (*.*); you cannot rename files as they are restored 
by RMSRST. You can omit the version or use a wild card 
character; RMSRST will use the version of the original file. 


If you omit the account field of the file specification, RMSRST 
will restore the files to your default account. If you specify 
[*,*], RMSRST will restore the files to the original accounts 
from which they were backed up. If you explicitly specify an 
account, RMSRST will restore the files to that account. 


infile 


The specification of a back-up file on disk or a container file. 
A container file is a magnetic tape file that contains RMS-11l 
files that were backed up using RMSBCK. You can use wild card 
characters (*) to specify multiple container files. 


If you omit the version and the input file is a container file, 
RMSRST applies the following defaults: 


e If wild card characters appear in either or both the container 
file name and type, RMSRST will restore all versions of the 
container file that satisfy the wild card specification. 


e If both the container file name and the type are explicitly 
specified, RMSRST will restore the first container file that 
it encounters that satisfies the specification and has a 
version of 0. 


To restore a specific data file from magnetic tape, you must 
specify the container file name and specify the data file name 
with the /SE input file switch (see Section 7.3.3). (You can use 
RMSDSP to display information about the files in a container 
file; see Chapter 5.) 


/switch 


One of the switches listed in Table 7-1 and described in Section 
Tusce 


In place of the command string, you can type HELP or ? to display 
help text about RMSRST, or /ID to display the current version of the 
utility. 
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[Ue - Table 7-1: RMSRST Switches ~ 


Type Switch Description 


Global /ID Identify current version 
Default: No identification 


/ [NO] CV Enable Or disable file 
version number conversion 


Default: Conversion enabled, 
if appropriate 


/ [NO] QU Enable or disable query mode 
Default: Query mode enabled 


/SL[:file-spec] Provide summary listing (in 
file, if specified) 


Default: No summary 
Output /FR Change protection code 
File 


Default: Original protection 


/RA Read-after-writing data 
integrity checking 


Default: No reading 


/RC Check-after-writing data 
integrity checking 


Default: No checking 
/SU Supersede existing files 
Default: No supersession 


Input /BD:dd-mmm-yy Restore disk files based on 
File back-up date 


Default: No date checking 


/OA: [act nbrj 1 Restore files based on 
original account 


Default: No account 
criterion applied 


/SE:file-spec or Restore specified files from 
/SE: (file-specl,file-spec2 container file 
[,..-,file-specl0]) 
Default: Restore all files 
on container file 


1. Square brackets are required with the act nbr argument. 
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RMSRST SWITCHES 


This section describes the global, output file, and input file 
switches that you can specify in the RMSRST command string. Global 
switches are switches that can be specified anywhere in the command 
stringdg. 


7.3.1 Global Switches 


The global switches are /CV, /ID, /QU, and /SL. 


/ [NO]CV 


/ID 


Enables or disables file-version number conversion: from decimal 
to octal for VAX/VMS files being restored to RSX-11M/M-PLUS 
systems. 


You can use RMSDSP to display information about files backed up 
using RMSBCK, including the radix of the version number; see 
Chapter 5. For more information about file transfer to different 
operating systems, see Section 7.4.3. 


For back-up files created using RMSBCK Version 1.8 or earlier, 
the default is /NOCV. You must specify /CV explicitly to force 
the conversion; RMSRST will assume that the file is from a 
"foreign" system (from RSX-11M/M-PLUS if RMSRST is being run ona 
VAX/VMS system, or from VAX/VMS if RMSRST is being run on an 
RSX-11M/M-PLUS system) and convert the file version number to the 
correct radix for the system on which the files are being 
restored. 


If the file was originally created and backed up on ae éeRSTS/E 
system, it will have no version number, and the /CV switch will 
have no effect. 


If the back-up file is not from a foreign system and you specify 
/CV, the file version numbers may be converted to incorrect 
values. 


For back-up files created using RMSBCK Version 2.0, the default 
is /CV. The file attributes preserved by RMSBCK include the 
radix of the version number. Version numbers will be converted 
automatically, if necessary, to the correct radix for the system 
on which the files are being restored. You can override the 
conversion with /NOCV. 


Displays the current version of the RMSRST utility. For example: 


The last two digits of the version number (00 in this’ example) 
are the patch level of the utility. The /ID switch can also be 
specified by itself on the command line: 


RST>/ID 
SRST-I-ID, Version 2.000 
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/ [NO] QU 
Enables or disables query mode. If you specify /QU, RMSRST will 


allow you to chose to continue or to terminate processing when 
one of the following occurs: 


e A read error occurs on an input file. 


e A read-after-write error occurs on an output file when the /RA 
switch is specified (see Section 7.3.2). 


e A read-after-write error occurs on an output file when the /RC 
Switch is specified (see Section 7.3.2). 


e The table allocated internally for data integrity checks. or 
for automatic retry of read errors is full 


When one of these errors occurs, RMSRST prints a diagnostic 
message specifying the type of error and the name of the file 
being processed. It also prompts you, asking whether you want to 
continue processing. If you answer Y, RMSRST will continue 
processing the current file and command string. If you answer N, 
RMSRST will terminate processing immediately, without processing 
the rest of the command string. 


For example: 


RST>OUTFIL.DAT/QU=INFILE. DAT 
?RST-F-WCE, Check after write error on output file OUTFIL.DAT 
VBN 1 to VB2. Continue (Yes or No)? Y 
?RST-F-TER, Integrity check table full. Continue (Yes or No)? N 


You can disable query mode with the /NOQU switch. RMSRST will 
print a diagnostic message when it encounters an error and 
terminate processing. 


By default, if you do not specify /QU or /NOQU, query mode will 


he enabled. 
/SL[:file-spec] 


Directs RMSRST to produce a esummary of file restoration 
processing. The summary listing consists of the following: 


@e The command string 
e The names of files successfully restored 


e The names of files that were not restored, with associated 
error messages 


e The diagnostic messages produced in query mode (if query mode 
was enabled) 


e A summary of any input errors and a summary of any errors 
remaining in restored output files after automatic retry of 
data integrity checks (if you specified /RA or /RC) 


If you specify a file as an argument to /SL, and a file of the 
same name and type already exists, RMSRST will append the summary 
to that file. You can thus use one file to keep a record of all 
file conversions. 


If you specify a file, and a file of the same name and type does 
not exist, RMSRST will create a new file and write the summary to 
that file. 


Teowe 
The o 


/ER 


/RA 
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If you do not specify a file, the summary will be written to your 
terminal. 


Do not specify either the input file or the output file as the 
argument to /SL. 


By default, if you do not specify /SL, RMSRST will write messages 
to your terminal if it encounters errors (see Appendix C). 


Output File Switches 


utput file switches are /FR, /RA, /RC, and /SU. 


Directs RMSRST to change the protection code of a file when it 
restores it to disk. If the file is restored to the operating 
system from which it was backed up, RMSRST changes the protection 
code so that the default account (the account under which RMSRST 
is running) becomes the owner of the file. 


If the file being restored was created and backed up on another 
Operating system, RMSRST will set the protection code to the 
system default. For more information on intersystem file 
transfer, see Section 7.4.3. 


If the file is restored to an account other than the one from 
which it was backed up and /FR is not specified, RMSRST will 
interpret the account field as described in the definition of the 
outfile specification in Section 7.1. In this case, the 
protection code will not be changed: the original owner will 
remain the owner, and so on. 


By default, if you do not specify /FR, RMSRST will not change the 
protection code from the value copied when the file was backed 
up. 


Directs RMSRST to read the restored file after writing it. 
RMSRST reads back each block of the file after it has been 
completely restored. If the device hardware detects a read 
error, RSMRST will respond according to whether query mode is 
enabled (see the description of the /[NO]QU switch in Section 
Teel) 


Note that you cannot specify /RA and /RC in the same command 
string. RMSRST terminates with the fatal error message: 


?RST-F-CSW, Conflicting switch specified - /sw 


The value /sw is /RA or /RC depending on which appears second in 
the command string. 


By default, if you do not specify /RA, RMSRST will not perform 
read-after-writing data integrity checking. 


NOTE 


For multivolume backup sets, the /RA and 
/RC switches will not function properly 
since tape positioning cannot be 
accomplished on those files which span 
tape volumes. 
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Directs RMSRST to check the restored file after writing it. 
After the file has been completely restored, RMSRST reads it back 
into memory block by block. At the same time it reads the input 
(back-up) file back into memory block by block. RMSRST compares 
corresponding blocks of the files as it reads them. If an error 
occurs during the comparison (a hardware read error or a mismatch 
between the contents of the blocks), RMSRST will respond 
according to whether query mode is enabled (see the description 
of the /[NO]QU switch in Section 7.3.1). 


Note that you cannot specify /RC and /RA in the same command 
string. RMSRST terminates with the fatal error message: 


?RST-F-CSW, Conflicting switch specified - /sw 


The value /sw is /RA or /RC depending on which appears second in 
the command line. 


By default, if you do not specify /RC, RMSRST will not perform 
check-after-writing data integrity checking. 


Directs RMSRST to supersede an existing output file with the 
records of the input file. RMSRST deletes the existing file, 
creates one of the same name, type, and version, and writes the 
records of the input file to it. 


By default, if you do not specify /SU and an output file already 
exists with the same name, type, and version, RMSRST will print 
the following error message and continue processing (RMSRST does 
not restore duplicate files): 


?RST-F-ERSFEX, File <file-spec> already exists 


Input File Switches 


The input file switches are /BD, /OA, and /SE. 


/BD:dd-mmm-yy 


Directs RMSRST to restore disk files based on their back-up date. 
If you use wild card characters in the input file specification 
and specify this switch, you can restore specific files within a 
group of disk files. RMSRST will restore only the files that 
satisfy the wild card specification and were backed up on_ the 
specified date. 


Note that you cannot use the /BD switch if the input files are 
stored on magnetic tape; RMSRST cannot access the creation date 
of a file on magnetic tape. If the input file is on magnetic 
tape and you specify /BD, RMSRST will terminate with the fatal 
error message: 


?RST-F-LSW, Illogical switch in context of command - /BD 
By default, if you do not specify /BD, RMSRST will apply no date 


criterion in restoring files: all files that satisfy the input 
file specification will be restored. 
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/OA: [act nbr] 


Directs RMSRST to restore files based on the account from which 
the original files were backed up. The [act nbr] argument is the 
User Identification Code (UIC). The square brackets are required 
with the UIC. 

If you use wild card characters in the input file specification 
and specify this switch, you can restore specific files within a 
group of disk or magnetic tape files. RMSRST will restore only 
the files that satisfy the wild card specification and were 
backed up from the specified account. 


By default, if you do not specify /OA, RMSRST will apply no 
account criterion in restoring files: all files that satisfy the 
input file specification will be restored. 


/SE:file-spec 
/SE: (file-specl,file-spec2[,...,file-specl0]) 


Direct RMSRST to restore the specified data files from magnetic 
tape container files. You can specify from 1 to 10 files; 


multiple file specifications must be enclosed in parentheses and 
separated by commas. 


The file specification can contain only a file name, type, and 
version. Wild card characters are permitted. If you omit the 
version, RMSRST will apply the following defaults: 


e All versions of the file will be restored if any one of the 
following conditions exists: 


- The file name or type is a wild card character. 
- The /OA switch is not specified for the container file. 


- The /OA switch is specified for the container file but 
contains wild card characters. 


e The first version of the file that RMSRST encounters will be 
restored if either of the following conditions exists: 


- Neither the file name nor type is a wild card character. 


- The /OA switch is specified and contains no wild card 
characters in the file specification. 


By default, if you do not specify /SE, RMSRST will restore all 
the files in the specified container file. 


7.4 RMSRST PROCESSING 


RMSRST restores data files that were backed up on disk or magnetic 
tape (container files) using the RMSBCK utility (see Chapter 6). 
RMSRST translates the container files into standard RMS-1l data files 
with the form, structure, contents, and attributes (with the exception 
of file placement) of the original data files when they were backed 
up. 


RMSRST provides six processing features, as described in the following 
sections. 
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7.4.1 Explicit and Implicit Input File Specification 


The RMSRST command string allows you to specify input files either 
explicitly or implicitly. File specifications with wild card 
characters (*) implicitly identify a collection of files. When you 
use wild card characters, you can restrict the number of files 
selected for processing by including the /BD input file switch (see 
Section 7.3.3), which selects disk files on the basis of their back-up 
date. 


7.4.2 Choice of Restoration Account or Volume 


You can use the /OA input file switch to select specific data files 
from the back-up files based on the account in which the data file 
Originally resided (see Section 7.3.3). 


7.4.3 Intersystem File Transfer 


You can use RMSBCK and RMSRST to transfer files between different 
operating systems, for example, between RSX-11M/M-PLUS and VAX/VMS 
systems, and between RSTS/E and RSX-11M/M-PLUS or VAX/VMS systems. 


Note, however, that VAX/VMS file versions are numbered in decimal and 
RSX-1L1IM/M-PLUS file versions are numbered in octal. RMSBCK preserves 
the radix of the file's version number: a file that was created and 
backed up on an RSX-1IM/M-PLUS system has an octal version number; a 
file that was created and backed up on a VAX/VMS system has a decimal 
version number. RMSRST uses this information to determine whether the 
version number should be converted to decimal or octal. 


If the files you are restoring (with RMSRST Version 2.0) were backed 
up using RMSBCK Version 2.0, the version numbers will be converted 
automatically to the proper radix. RMSBCK Version 2.0 preserves the 
attributes of the files packed up, including the radix ot the version 
number. You can override the conversion by specifying /NOCV. 


If, however, the files were backed up using RMSBCK Version 1.8 or 
earlier, the version numbers will not be converted automatically. You 
can specify the /CV switch to ensure that the version numbers are 
converted to the proper radix. For example, if you are restoring 
files to RSX-11M/M-PLUS that were backed up using RMSBCK Version 1.8 
or earlier on VAX/VMS, you can specify /CV to convert the version 
numbers from decimal to octal. 


RSTS/E does not support file version numbers. No conversion is 
necessary, therefore, for files created and backed up on RSTS/E and 
restored to RSX-11M/M-PLUS or VAX/VMS. The /CV switch has no effect 
for these files. 


See Section 7.3.1 for more information on the /CV switch. 


You can use RMSDSP (with the /FU switch) to display the attributes of 

files backed up by RMSBCK; see Chapter 5, Example 5-7. The display 

will indicate the radix of the version number for RSX-11M/M-PLUS- and 

VAX/VMS files. It no version number appears in the file 
1 


specification, the f1 ted on a RSTS/E system. 


ee eee ee 
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NOTE 


Be careful when restoring files created 
on RSTS/E systems to RSX-11M/M-PLUS and 
VAX/VMS systems. Files marked 
"Record format=Stream (RSTS/E)" in the 
RMSDSP display were not created using 
RMS-11 and have no attributes. RMS-11 
can process ‘these files on 
RSX-11M/M-PLUS and VAX/VMS systems; 
however, because RSTS/E does not 
maintain information on the largest 
record written in a file, these files 
may not be restored properly to other 
operating systems. 


For information on restoring files created and backed up on 
RSX-11M/M-PLUS and VAX/VMS systems to RSTS/E systems, see the RSTS/E 
RMS-11 Utilities manual. 


7.4.4 Data Integrity Checking 


You can direct RMSRST to check data integrity as each file is 
restored. If you specify the /RA output file switch, RMSRST will read 
back the contents of the restored file. If you specify the /RC output 
file switch, RMSRST will read back, block by block, the contents of 
the output (restored) file and the contents of the input file and 
compare them. RMSRST automatically retries any read errors if 
processing continues to normal termination. 


Thus, you have three choices in data integrity checking: 


@® You can specify neither /RA nor /RC and rely on software and 
hardware accuracy, backing up your files in minimum time. 


@e You can specify /RA and verify that the restored files can be 
read, adding reading time to the minimum time. 


@ You can specify /RC and verify that the restored files can be 
read and that they exactly match the back-up files, adding 
reading time and comparison time to the minimum time. 


See Section 7.3.2 for descriptions of the /RA and /RC switches. 


7.4.5 Extended Diagnostic Messages 


allows you to specify that processing continues or 
terminates when RMSRST encounter an error condition. By default, 
query mode is enabled. When RMSRST encounters an error, it issues a 


diagnostic message to your terminal and prompts you: 
Continue (Yes or No)? 


Depending on your response, RMSRST continues or terminates processing. 
With this feature, you can ensure’ that RMSRST does not terminate 
processing of a group of files if errors are encountered in only one 
file. 
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you can disable query mode with the /NOQU output file switch. Tf 
RMSRST encounters an error, it will issue a diagnostic message to your 
terminal and immediately terminate processing. 


See Section 7.3.1 for a description of the /[NO]QU switch. 


7.4.6 Summary Listing 


You can use the /SL switch to produce a summary listing of RMSRST 
processing, including data integrity checks and error messages. 
RMSRST will either write the summary to your terminal or into a file 
that you specify, creating a permanent record of restoration 
processing. 


See the description of the /SL switch in Section 7.3.1, and _ the 
example summary listing in Section 7.5. 


7.5  RMSRST EXAMPLES 


>MOU MMO: PAYROL 

>RST *.*:*/SU/SL=MMO: PAYROL.CON 

$RST-I-FPC, Processing complete for file DB0O:[{70,5]PAYROL.DAT;2 
$RST-I-FPC, Processing complete for file DBO:[70,5]PAYROL.LOG;1 
$RST-I-FPC, Processing complete for file DBO:[70,5]PAYROL.DES;2 
$RST-I-FPC, Processing complete for file DBO:[70,5] PAYROL.SEQ;2 
$RST-I-FPC, Processing complete for file DBO:[70,5]PAYROL.MST;1 


RMSRST searches the magnetic tape volume mounted on MMO: for the 
container file, PAYROL.CON. The files in the container file are 
restored to their original form in the default (user's) account on 
SY:. 
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Because the /SU switch is specified, if the current account contains a 


file with the same file name and extension, RMSRST will supersede the 
existing file with the file being restored. 


>RST *.*:*=MMO0:MASTER.BCK/SE: (STAT.DAT,ACCNT.DAT) 
$RST-W-ERSFEX, File DB0O:[70,5]STAT.DAT;1 already exists 
%RST-W-ERSFEX, File DB0O:[70,5]ACCNT.DAT;1 already exists 
>RST *.*3*/SU=MM0:MASTER.BCK/SE: (STAT.DAT,ACCNT. DAT) 


In both examples, RMSRST searches the volume mounted on MMO: for’ the 
first occurrence of the container file MASTER.BCK. RMSRST searches 
this file for the files STAT.DAT and ACCNT.DAT. RMSRST then attempts 
to restore these files to their original form in the default account 
on SY:. 


In the first example, the files cannot be restored because files with 
the same name already exist in the default. In the second example, 
the /SU switch is specified so that the files in the default account 
(on SY:) are superseded by the files restored from tape. 


>RST [70,2]*.*;*/SU/SL: RESTOR. LOG=DBO0: [70,1]*.*;*/BD:02-APR-83,MMO:*.*;% 
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>TYP RESTOR.LOG 


RMSRST VERSION 


RST-I-FPC, 
RST-I-FPC, 
RST-I-FPC, 
RST-I-FPC, 
RST-I-FPC, 
RST-I-FPC, 
RST-I-FPC, 
RST-I-FPC, 
RST-I-FPC, 
RST-I-FPC, 
RST-I-FPC, 


Processing 
Processing 
Processing 
Processing 
Processing 
Processing 
Processing 
Processing 
Processing 
Processing 
Processing 


complete 
complete 
complete 
complete 
complete 
complete 
complete 
complete 
complete 
complete 
complete 


for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 


file 
file 
file 
file 
file 
file 
file 
file 
file 
file 
file 


RMSRST 


2.000 O2-APR-1983 01:49:43 
[70,2]*.*;*/SU/SL: RESTOR. LOG=DB0: [70,1]*.*;*/BD:02-APR-83,MM0:*.*;* 


DBO:[70,2]CUST.FIL;1 

DBO:[70,2]CUST.SEQ;1 

DBO: [70,2] PAYROL.DAT;2 
DBO:[70,2]STAT.DAT;1 

DBO: [70,2] EMPLY.DAT;1 
DBO: [70,2] ACCNT.DAT;1 
DBO: [70,2] PAYROL.DAT;2 
DBO: [70,2] PAYROL.LOG;1 
DBO: [70,2] PAYROL.DES;2 
DBO: [70,2] PAYROL.SEQ;2 
DBO: [70,2] PAYROL.MST;1 


RMSRST reads all files in 
up on April 2, 1983, 
Then, RMSRST restores the 


the account [70,1] on DBO: that were backed 
and restores them to account [70,2] on SY:. 
files within all container files on MMO:. 


As it writes the files to SY:, RMSRST supersedes any existing files 
having the same file name and extension with the file being restored. 
RMSRST also writes a summary listing to RESTOR.LOG; the contents of 
this file are displayed. 


APPENDIX A 


RMS-11 FILE DEFINITION OTILITY: RMSDEF 


A.1 PURPOSE 


The interactive RMS-11l File Definition Utility (RMSDEF) creates RMS-11 
files, allowing you to control all attributes of the files being 
created. 


You specify file attributes by responding to requests for data and 
questions from RMSDEF. The method of questioning is outlined in 
Figure A-l. The figure shows the general flow of processing while 
Section A.4 shows actual messages and valid responses as well as the 
meaning of each attribute. You can also get help from the utility by 
typing a question mark (?) in response to any question or request for 
data. 


RMSDEF can also build an indirect command file while you operate the 
utility. This command file can be used thereafter to (re)create 
file(s) and can be modified to create other similar files. See 
Sections A.3.1 and A.4.1. 


NOTE 
Command files generated by RMSDEF are 


not compatible across operating systems. 


RMSDEF, however, does not write records into the file. The actual 
data contents of the file must be loaded after the RMSDEF utility 
creates the file. You can use either an application program, the 
RMSCNV utility, or the RMSIFL utility to write records into the file. 


NOTE 


RMSDEF interprets all quantities you 
enter as decimal numbers. 
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The following list indicates the information that RMSDEF always 
requests as well as the requests that depend on specifications typed. 
1. Command File? 
a. If yes, file specification 


b. If yes, create only command file or create both RMS-11 
and command files? 


2. File Specification and Supercession Information 
3. Data Structure 
a. Minimum 
1. File organization 
2. Record format 
3. Maximum record size 
4. CARRIAGE RETURN control? 
b. Possible 
1. Size of fixed control area for VFC records 
2. Maximum number of records in a relative file 
3. Block-spanning records in a sequential file? 


4. FORTRAN character control if no CARRIAGE RETURN 
control? 


4, Key Definition (indexed files only) 
a. Minimum 
1. Position of key 
2. Size of key 
3. Data type 
4. Name of key 
5. Duplicate keys? 
b. Possible 
1. Change keys if duplicatable? if alternate key 
2. Null key value? if alternate key 
3. Null key character if null key value 
5. File Structure 
a. Minimum 
1. Areas? (indexed files only) 


2. Placement control? 
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3. Initial allocation quantity 


4. Default extensio 


5. Contiguous? 


Possible 


nm quantity 


1. Location if placement control 


2. Exactly if placement control? 


3. Type of alignment if placement control and areas 


Data Allocation (indexed files only) 


a. Minimum 
1. Number of bytes 
2. Number of bytes 
b. Possible 
1. Area containing 
2. Area containing 
3. Area containing 
Protection 


in data buckets filled 


in index buckets filled 


index level 0 for each key if areas 
index levels 2+ for each key if areas 


index level 1 if areas 
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Figure A-1: RMSDEF Processing Flowchart 
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A.3 CALL AND TERMINATION 


A.3.1 Calling the Utility 


The RMSDEF utility can be either installed or uninstalled. If RMSDEF 


is installed, invoke it with the command: 
DEF [command-string] 


where command-string is one of the following: 


@file-spec if you want RMSDEF to read a command file named file-spec 
that was previously generated by RMSDEF (see Section 
A.4.1). The utility processes’ the file, printing 
messages only when it comes to the file creation phase 


(see Section A.4.8). 


HELP or ? if you want an introductory HELP message for the RMSDEF 
utility. 
/ID if you want the version number of the RMSDEF utility 


installed on your system. RMSDEF prints the following 


message: 
THIS IS THE RMS DEFINE UTILITY, VERSION 2.000 
where nn is the patch level of the utility. 
If you do not include a command string, the utility prints: 
DO YOU WANT TO GENERATE A COMMAND FILE FOR FUTURE USE (NO)? 
See Section A.4 for the complete dialog sequence. 


If RMSDEF is uninstalled on RSX-11M/M-PLUS systems, type the 
command : 


RUN SRMSDEF 
The utility prints: 
DO YOU WANT TO GENERATE A COMMAND FILE FOR FUTURE USE (NO)? 


See Section A.4 for the complete dialog. 


A.3.2 Terminating the Utility 


MCR 


You may terminate RMSDEF at any time by typing a CTRL/Z. The current 
keyboard monitor or command interpreter resumes control of your 


interface. 


A.4 PROCESS 
A.4.1 Command File 


Ly The terminal prints: 


DO YOU WANT TO GENERATE A COMMAND FILE FOR FUTURE USE (NO)? 
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Type one of the following: — 


Y if you want to enter a file-spec for an indirect 
command file and RMSDEF to write entries into the 
file as you move through the utility. Go to _ step 
2 


N or (e?) if you do not want to build a command file. Go to 
Section A.4.2. 


@file-spec if you have already built a command file with 
RMSDEF and want RMSDEF to read it now and create 
the specified file. Go to Section A.4.8. 


/ID if you want the utility to identify itself with a 
version number. RMSDEF prints the _ following 
message: 


THIS IS THE RMS DEFINE UTILITY, VERSION 2.0 
where: 
mn is the patch level of the utility. 
The terminal prints: 
ENTER FILE SPECIFICATION FOR COMMAND FILE: 
Type a file specification. See the RSX-11M/M-PLUS RMS-11l User's 
Guide restrictions on file specifications defined by your 
operating system documentation. 
The terminal prints: 
DO YOU WANT TO CREATE THE FILE YOU WILL BE DESCRIBING (NO)? 
Type one of the following: 


p 
i - Maan 

y if you want RMSD 
el 


specified as w 


EF to create the RMS-il file being 
1 as the command file. 


N or (é) if you do not want to create the RMS-1ll file, only 
the command file that can be used to create the 
file later. 


NOTE 


The command file created by RMSDEF takes 
the following form shown. The utility 
follows each comment with the 
appropriate sequence of your entries, 
each on a separate line. Where you 
press RETURN to accept the default 
value, RMSDEF places the CR/LF character 
sequence on a separate line in the 
command file. 


;THE FIRST QUESTION ASKS FOR THE FILE SPECIFICATION. 


:;THE NEXT QUESTIONS DEAL WITH FILE ORGANIZATION & RECORD 
ATTRIBUTES 


;THE FOLLOWING QUESTIONS DEAL WITH KEYS (for indexed files only) 
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;THE NEXT QUESTIONS DEAL WITH ALLOCATION AND PLACEMENT ATTRIBUTES 


;THE NEXT QUESTIONS ASK ABOUT FILL SIZES FOR KEYS (for indexed 
files only) 


;THE FOLLOWING QUESTIONS DEAL WITH FILE PROTECTION 


A.4.2 File Specification 


1. 


The terminal prints: 
ENTER FILE SPECIFICATION: 
Type one of the following: 


file-spec if you want to create (or simulate the creation of; 
see Section A.4.1, step 3) an RMS-11 file. Type a 
file specification as defined by your operating 
system documentation; see also the RSX-11M/M-PLUS 
RMS-~11 User's Guide for RMS-ll restrictions on file 
specifications. Go to Section A.4.3. 


@file-spec if you have built a command file (see "Command 
File," Section A.4.1) and want RMSDEF to use it and 
create the file specified. Go to Section A.4.8. 


The terminal prints: 


IF THE FILE ALREADY EXISTS, DO YOU WANT TO SUPERSEDE IT 
(NO) ? 


It is possible that a file already exists with the file 
specification you entered in step 1. Note that a conflict will 
result if you specified a version number in that specifiction. 
You must tell RMSDEF what to do if such a conflict occurs when it 
tries to create the file you describe during this interactive 
session. 

Type one of the following: 

Y if you want RMSDEF to supersede an existing file. 


N or @ED if you do not want RMSDEF to create the file you 
will describe by superseding a file that exists. 
CAUTION 
1. If you say "N" here, and 


2. If you are generating a command 
file, and 


3. If you describe other files after 
this one in that command file, and 


4. If, when you use the command file, a 
file with the file specification 
entered in step 1 exists: 
RMSDEF prints the following error 
message and terminates processing of the 
command file. 
A FILE WITH THE FILE SPECIFICATION YOU ENTERED ALREADY EXISTS 


A-7 
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A.4.3--Data-Structure-- = >> 


1. 


The terminal prints: 
ENTER FILE ORGANIZATION (SEQ): 


Type one of the following: 


SEQ or for sequential organization 

REL for relative organization 

IDX for indexed organization 
NOTE 


If you indicated a magnetic tape device 
in the file specification, RMSDEF does 
not request a file organization. Since 
a magnetic tape file requires sequential 
organization, the utility prints: 


SINCE YOU SPECIFIED A NON-DISK DEVICE, YOUR FILE 
ORGANIZATION MUST BE SEQUENTIAL! 


The terminal prints: 
ENTER RECORD FORMAT (VAR): 
Type one of the following: 


VAR or (ED if the records in the file have differing, or 
variable, lengths. 


FIX if the records in the file have the same, or a 
fixed, length. 


VEC if each cecord in tne file has a control area 
with a fixed length and a data area of no 
standard length, that is, variable with fixed 


control. 

STM if the records in the file have no_ specific 
format, but are delimited only by record 
terminator characters. The stream format is 


permitted for sequential disk files only. 


UDF if there are no records (or you do not want 
RMS-11 to recognize records) in the file; this 
format is used only for block I/O files, such as 
RMS-11 back-up files. The undefined format is 
permitted for sequential disk or tape files only. 


RMSDEF rejects a format that conflicts with the file organization 
specified, for instance, STM for indexed files. 


If you specified VFC in step 2, the terminal prints the following 
message; otherwise, go to step 4, 


ENTER SIZE OF FIXED CONTROL AREA (2): 
Type the decimal number of bytes in the fixed control area of 


each record in the file. The minimum size is 1 byte; the 
maximum size is 255 bytes; the default is 2 bytes. 
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The terminal prints: 


ENTER MAXIMUM RECORD SIZE: 
or 
ENTER MAXIMUM RECORD SIZE (0): 


Type a decimal number indicating the maximum number of bytes in 
any record in the file. RMS-11 checks this value whenever a 
record access operation is requested for this file: if the 
record specified exceeds the maximum size, RMS-11 returns an 
error. A size of zero disables the RMS-11 check, but a nonzero 
value is required for all relative files and all files with 
fixed-length records. 


If you specified REL in step 1, the terminal prints the following 
message; otherwise, go to step 6. 


ENTER MAXIMUM NUMBER OF RECORDS (0): 


Type a decimal number indicating the maximum number of records 
that this relative file will contain. RMS-11 checks this value 
whenever a record access operation is requested for this file: 
if the relative record number specified exceeds the maximum 
record number, RMS-11 returns an error. Pressing RETURN sets the 
number to zero, which disables the RMS-11 check. The zero allows 
the file to contain as many records as is physically possible 


(the technical maximum is 2.14748 x 10**9 or 2,147,800,000). 


If you specified SEQ in step 1, the terminal prints the following 
message; otherwise, go to step 7. 


WILL YOU ALLOW RECORDS TO CROSS BLOCK BOUNDARIES (YES)? 

Type one of the following: 

Y or (é if you want records to cross block boundaries. 

N if you do not want records to span blocks. If you 
specified FIX in step 2 and a maximum record size 
greater than 512 in step 4, the terminal prints: 

SINCE YOU SPECIFIED FIXED LENGTH RECORDS, YOU MUST HAVE A 
MAXIMUM RECORD SIZE LESS THAN 512 BYTES (THE SIZE OF ONE 
BLOCK) OR YOU MUST ALLOW RECORDS TO CROSS BLOCK BOUNDARIES. 
PLEASE CHANGE ONE OF THESE. 


RMSDEF repeats steps 4 and 6. Change either your maximum record 
size or the answer to crossing block boundaries. 


The terminal prints: 
DO YOU WANT CARRIAGE RETURN CONTROL (YES) ? 
Type one of the following: 
Y or GET if you want each record to be preceded by a line 
feed character and followed by a carriage return 
character when it is written to a unit record 


device (printer, terminal, and so on). See the 
following note and go to appropriate section. 


N if you do not want CARRIAGE RETURN control and/or 
you do want FORTRAN character control. Go to step 
8. 


As in 
files 


The terminal prints: ~ 
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DO YOU WANT FORTRAN CHARACTER CONTROL (NO) ? 


Type one of the following: 


Y if you want the first byte of each record to 
interpreted as a FORTRAN forms control character 
when the record is written to a unit record device. 


N or (Er if you do not want FORTRAN character control. 


NOTE 
If you indicated a magnetic tape devi 
in the file specification, at this poi 
RMSDEF requests: 


ENTER MAGTAPE BLOCK SIZE (512): 


ce 
nt 


Type a decimal number between 18 and 


8192 representing the number of bytes 


in 


each tape block. The number should be a 


multiple of 4; if it is not, RMS-11 
rounds the number up to the next 
multiple of 4 before writing it as an 


attribute. Pressing RETURN sets’ the 


size to the default of 512 bytes. 


The utility then bypasses other 
processing and immediately requests 
protection information (see Section 
ReAs 7) % 


Key Definition 


dicated by Figure A-1l, this section applies 


IT'S TIME TO DEFINE THE PRIMARY KEY 
The terminal prints: 
ENTER DATA TYPE (STR): 


Type one of the following: 


be 


only to indexed 
- RMSDEF begins this portion of dialog with the message: 


STR or {fe if your key value is a string of alphanumeric 
characters, 

INT if your key value is a 2- or 4-byte signed 
integer. 

BIN if your key value is a 2- or 4-byte unsigned 


binary number. 


PAC if your key value is a packed decimal number. 


See the RSX-11M/M-PLUS RMS-11 User's Guide for 
key data types. 


a discussion 


of 
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The terminal prints: 
ENTER POSITION OF KEY: 


Type a decimal number indicating the position of the first byte 
of the key within each record. For instance, if the key starts 
with the first byte of the record, its position is 0. The second 
byte has position 1 and so on. 


A position number must be specified for each segment of a 
segmented string key; the numbers are separated by commas and 
enclosed in parentheses. Integer, inary, and packed decimal 
keys cannot be segmented. For example, if a key has three 
segments that start at the first, fourth, and sixteenth 
positions, they are described as follows: 


(0,3,15) 
The terminal prints: 
ENTER SIZE OF KEY: 


its length. 


’ 
rm dle 
v ie 


Type the decimal number of bytes in the key 
Valid lengths depend on the data type enter 


Data Type Length Restrictions 
STR Minimum = 1 byte 
Maximum = 255 bytes 
INT 2 or 4 bytes 
BIN 2 or 4 bytes 
PAC Minimum = 1 byte 
Maximum = 16 bytes 


A length must be specified for each segment of a segmented string 
key; the numbers are separated by commas and enclosed in 
parentheses. A length must be typed for each position number 
specified in step 1, but the sum of all lengths cannot exceed 
255. Integer, binary, and packed decimal keys cannot be 
segmented. For example, the lengths of the keys in the step 2 
example would be entered as follows: 

(2,2,16) 
The terminal prints: 

ENTER NAME OF KEY (NONE) : 
Type one of the following: 
RET if you do not want to specify a key name. 


name if you want to name the key being defined; up to 32 
ASCII characters are allowed. 


The terminal prints: 


WILL YOU ALLOW DUPLICATE KEYS (NO)? 
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Type one of the following: 

Y if the file may contain more than one record with the same 
value for this key. Alternate keys must be specified as 
duplicatable before they can be specified as changeable (in 
step 6). 

N if each record in the file must have a unique value for this 
key. RMS-11 returns an error if duplication is attempted; 
that is, put or update operations fail when the record has a 
value in this key field exactly like a record already in the 
file. 

Defaults and the values of dflt are: 

Primary Key No 
Alternate Keys Yes 


When defining the primary key, go to step 10. Otherwise, go to 
step 6. 


If you specified Yes in step 5, the terminal prints the following 
message; otherwise, go to step 7. 


WILL YOU ALLOW KEYS TO CHANGE (YES) ? 
Type one of the following: 
Y or (é) if this alternate key can change values during an 
update operation; that is, the record may be read 
with one value for the key and rewritten with 


another value for the same key. 


N if this alternate key must not change after the 
record is originally created. 


The terminal prints: 

DO YOU WISH TO DEFINE A NULL KEY VALUE (NO)? 

Type one of the following: 

x if you want the file to contain some records’ that 
cannot be accessed via this key. See the 
RSX-11M/M-PLUS RMS-11 User's Guide. Go to step 8 
only if you specified a string key (step 1). 
Otherwise, go to step 9; the other key data types 
have a null key value of 0. 


N or (ED if you do not want to specify a null value for this 
key. Go to step 9. 


The terminal prints: 
ENTER NULL KEY VALUE CHARACTER: 


Type one of the following: 


c the single character itself, if it is not #, ?, @, or 
PACE. 

#40 for SPACE. 

#43 for the reserved cnaracter #. 


10. 
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#77 for the reserved character ?. 
#100 for the reserved character @. 
#nnn any octal byte value (000-377), specified by nnn. 


The terminal prints: 
JUST FINISHED ALTERNATE KEY nnn 
where: 


nnn starts with 1 and is incremented when you answer Yes to 
the next question (step 10). 


The terminal prints: 
DO YOU WANT TO DEFINE MORE KEYS (NO)? 
Type one of the following: 


6 4 if you want to define more keys for the file. You 
may define up to 254 alternate keys; however: 


@ The RMSIFL and RMSCNV utilities do not read 
higher than the ninth alternate key; that 
is, the /KR switch must be less than or 
equal to nine (see Chapters 3 and 4). 


@ Your application language may not support 
that many keys. See your language manual. 


RMSDEF then requests the information (in steps 1-9) 
for each alternate key indicated; the alternate 
keys are defined in order, beginning with the first 
alternate after the primary key is defined. 


N or (Er if all keys for this file are defined. 


A.4.5 File Structure 


1. 


If you specified IDX for indexed file organization, the terminal 
prints the following message; otherwise, go to step 2. 


DO YOU WANT TO DEFINE AREAS (NO)? 
Type one of the following: 


Y if you want parts of this file to be logically 
different, with different attributes. See the 
RSX-11M/M-PLUS RMS-11 User's Guide. The following 


ne ae Seated A wee ate cme _— we TS Ss 


questions (steps 2-9) are asked for each area. 
N or @é) if you want this indexed file located in one area. 


RMSDEF requests the following information (steps 
2-9) for the file once. 
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The terminal prints: 
DO YOU WANT PLACEMENT CONTROL (NO)? 
Type one of the following: 


Y if you want to specify an exact location on _ disk 
for this file or area. Go to step 3. 


N or if you do not want to specifically locate this file 
or area. Go to step 6. 


On RSX-11M systems, the terminal prints the following message 
only for areas 1+ in indexed files. 


ENTER TYPE OF ALIGNMENT (LBN): 
Type one of the following: 


LBN or fe) if the location you will specify in step 4 is a 
logical block number (LBN) on the disk volume. 


VBN valid only for areas 1+ in indexed files, if the 
location you will specify in step 4 is a virtual 
block number (VBN) already established within the 
file>; that is, you are trying to closely align 
this area with a defined area. 


The terminal prints: 
ENTER LOCATION: 


Type the decimal number location of the first block for this file 
area. There is no default. For the first area defined, this 
number is a logical block number. 


The terminal prints: 
EXACTLY (NO)? 
Type one of the following: 


Y if this file or area must start in the exact LBN 
location specified in step 4. If this location is 
not available, RMSDEF prints an error message after 
it tries to create the file. Exact VBN locations 
are already taken, by definition. 


N or (é) if you will accept the closest approximation of the 
LBN or VBN location specified in step 3, when the 
exact location is not available. 


The terminal prints: 
ENTER INITIAL ALLOCATION IN BLOCKS (0): 


Type a decimal number indicating the initial size of the file or 
area in blocks. Pressing RETURN sets the value to zero: the 
area will be created, but it must be extended before any records 
can be written into it. Since automatic file extension is time 
consuming, the file should be fully allocated when it is created 
(see the RSX-11M/M-PLUS RMS-11 User's Guide). 
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NOTE 


If you have specified placement control 
(step 2), you should type a nonzero 


allocation quantity. An initial 
allocation of zero blocks essentially 
nullifies placement control: the file 


processor does not allocate any blocks 
to the file, so it does not use _ the 
placement control information. For 
example, you can place multiple files at 
the same LBN location, even answering 
YES to EXACTLY? (step 5), as long as 
you use zero allocation quantities for 
all but one. 


If you specified REL or IDX for file organization, the terminal 
prints the following message; otherwise, go to step 8. 


BUCKET SIZE (1): 


a cating the number of blocks in a bucket 
this file or area. The minimum is the number of blocks that 
can contain one record (according to the size specified; see 
Section A.4.3, step 4); the maximum is 32 blocks; the default 
is 1. This number determines the number of blocks read _ into 
memory during each file access operation and therefore affects 
processing speed and the amount of memory a program accessing 
this file requires. See the RSX-11M/M-PLUS RMS-11 User's Guide. 


decimal number indi 
i 


The terminal prints: 
ENTER DEFAULT EXTENSION QUANTITY IN BLOCKS (0) 


Type a decimal number indicating the number of blocks that should 
be added to the file or area each time RMS-11 extends it. The 
default extension quantity (DEQ) should be a multiple of the 
bucket size. RMS-11 requests this number of blocks from the 
operating system when it extends the file or area. 


Pressing RETURN sets the value to zero: RMS-11 adds only the 
minimum space required each time it expands the file or area. A 
definite, but reasonable extension quantity speeds processing. 
The terminal prints one of the following messages: 
DO YOU WANT A CONTIGUOUS AREA (NO) ? 

or 
DO YOU WANT A CONTIGUOUS FILE (NO)? 

Type one of the following: 

y if you want the disk space for this file or area allocated 
in contiguous’ blocks. If the file processor cannot find 
that many contiguous blocks, it will not create the file, 
even if enough noncontiguous blocks are available. 

A contiguous file or area may be extended although the disk 


space added may not be contiguous with the original 
allocation. 
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If you answered Yes in step 1 (you have an indexed file), the 
terminal prints the following messages; otherwise, go to the 
next appropriate section. 


JUST FINISHED WITH AREA NUMBER nnn 
DO YOU WANT TO DEFINE MORE AREAS (NO)? 


Type one of the following: 


Y if you want to specify attributes for another area 
of your file. Areas are numbered sequentially, 
starting with zero. The areas are associated with 
the index and data portions of the file in the next 
section of the utility. Go to step 2. 


N or @éD if you have defined enough areas for this file. Go 
to step ll. 


If you defined one or more areas with a DEQ of zero, the terminal 
prints the following message; otherwise, go to the next section. 


ENTER FILE DEFAULT EXTENSION QUANTITY (0): 


Type a decimal number indicating the number of blocks that should 
be added to the file each time RMS-11 extends it. The DEQ should 
be a multiple of the bucket size. Pressing RETURN sets the value 
to zero: RMS-11 will add only the minimum space required each 
time it expands the file. A definite, but reasonable extension 
quantity speeds processing. 


A.4.6 Data Allocation 


As indicated by Figure A-l, this section applies only to indexed 
files. RMSDEF begins this portion of dialog with the message: 


IT 1S TIME FOR AREA NUMBERS KEYS. 


The questions are asked for each key defined (see Section A.4.4). 
RMSDEF begins the first session with the message: 


THESE QUESTIONS ARE FOR THE PRIMARY KEY 


Any further sessions begin with the message: 


THESE QUESTIONS ARE FOR ALTERNATE KEY NUMBER nnn 


where: 


nnn 


l. 


starts with l. 
The terminal prints: 
ENTER AREA NUMBER FOR DATA BUCKETS FOR THIS KEY (0): 
Type an integer (0-n) indicating the area already defined (see 


Section A.4.4) that should contain the data portion (level 0) of 
this key's index. 
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The terminal prints: 


THE BUCKET SIZE IS nn 
ENTER FILL NUMBER FOR DATA BUCKETS (0): 


Type a decimal number of bytes in each of this key's data buckets 
that should be used during the original population of the file. 
This number is honored by the RMSCNV and RMSIFL utilities and may 
be honored by MACRO-11 programs. See the RSX-11M/M-PLUS RMS-11 


User's Guide. 


Pressing RETURN sets the number to zero, indicating that buckets 
will be filled and that no free space will be available in 
existing buckets for records added after the file is populated. 


The terminal prints: 

ENTER AREA NUMBER FOR INDEX BUCKETS FOR THIS KEY (0): 
Type an integer (0-n) indicating the area already defined (see 
Section A.4.4) that should contain the upper portions (levels 2+) 
of the index for this key. 


The terminal prints: 


THE BUCKET SIZE IS nn 
ENTER FILL NUMBER FOR INDEX BUCKETS (0) 


Type a decimal number of bytes in each of this key's' index 
buckets that should be used during the original population of the 
file. This number is honored by the RMSCNV and RMSIFL utilities 
and may be honored by MACRO-11 programs. 


Pressing RETURN sets the number to zero, indicating that buckets 
will be filled and that no free space will be available in 
existing buckets for records added after the file is populated. 


The terminal prints: 


ENTER AREA NUMBER FOR THE LOWEST INDEX LEVEL FOR THIS KEY (0): 


Type an integer (0-n) indicating the area already defined (see 
Section A.4.4) that should contain the lowest index level (level 
1) portion of this key's index. 


If the area you specified for the upper portions of the index 
(levels 2+) and the area you specified for level 1 have different 
bucket sizes, RMSDEF prints the following message and returns’ to 
step 3: 


THE AREA ASSOCIATED WITH THE LOWEST LEVEL INDEX BUCKET 
HAS A DIFFERENT BUCKET SIZE THAN THE AREA ASSOCIATED WITH 
THE HIGHER INDEX BUCKET. TRY BOTH AGAIN. 
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A.4.7 Protection 


1. 


The terminal prints: 


SPECIFY PROTECTION BY CLASS: 
OWNER (RWED ALLOWED) : 


Type one of the following: 


RET if you want this file available to access 
(Read, Write, Extend or Execute, Delete) by 
the account current when the file is 
created. 


NONE if you do not want the file owner to have 
access to this file after it is created. 


R, W, E, and/or D if you want to specify a level of protection 
between none and all. You may specify one 
or more of the letters representing Read, 
Write, Extend, and Delete without 
separation. 


The terminal prints: 
GROUP (RWED ALLOWED) : 
Type one of the following: 
(RET) if you want this file available to access 
(Read, Write, Extend or Execute, Delete) by 
accounts with the same group or project 


number as the owner's account. 


NONE if you do not want the group members to have 
access to this file after it is created. 


R, W, E, and/or D 1£f you want to specity a level otf protection 
between none and all. You may specify one 
or more of the letters representing Read, 
Write, Extend, and Delete without 
separation. 


The terminal prints: 
SYSTEM (RWED ALLOWED): 
Type one of the following: 
RET if you want this file available to access 


(Read, Write, Extend or Execute, Delete) by 
system privileged accounts. 


NONE if you do not want privileged accounts’ to 
have access to this file after it is 
created. 

R, W, E, and/or D if you want to specify a level of protection 


between none and all. You may specify one 
cr more cf the letters representing Read, 
Write, Extend, and Delete without 
separation. 
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4. The terminal spigess 
WORLD (R ALLOWED) : 
Type one of the following: 
RET if you want this file available for Read 
access only by all accounts’ outside the 


owner, group, and privileged accounts. 


NONE if you do not want other accounts to have 
access to this file after it is created. 


R, W, E, and/or D if you want to specify a level of protection 
other than none and Read only. You may 
specify one or more of the letters 


representing Read, Write, Extend, and Delete 
without separation. 


A.4.8 File Creation 

The RMSDEF utility attempts to create the file. 

Success ~-- If RMS-11 does not return an error, the utility prints: 
YOUR FILE HAS BEEN CREATED -- file-spec 


If you chose to create a command file (See Section A.4.1), RMSDEF also 
prints the following message. Otherwise, the utility requests you to 
enter another file specification (Section A.4.2). 


YOUR FILE HAS BEEN PROCESSED AND A COMMAND FILE GENERATED -- file-spec 
DO YOU WANT TO CLOSE THE COMMAND FILE (NO)? 


Type one of the following: 


Y if you are finished specifying files for the command 
file. The utility returns to the question about command 
file generation (see Section A.4.1). 


N or (Er if you want to specify another RMS-11 file and you want 
the command file to include your input. RMSDEF 
continues to use the command file originally specified 
and to obey your answer to the DO YOU WANT TO CREATE THE 
FILE YOU WILL BE DESCRIBING? question (see Section 
A.4.1, step 3). The utility returns to the request for 
a file specification (see Section A.4.2). 


You may start the process to create another file or type CTRL/Z to 
terminate the utility. 


Error -- RMSDEF allows you to recover from one type of creation error. 
The terminal prints an error description, followed by: 


DO YOU WISH TO REENTER THE ENTIRE FILE SPECIFICATION (YES) ? 
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Type one of the following: 

Y or (et if you know how to correct the error and/or want to 
enter another file specification. The utility requests 
the file specification and attempts to create the file 
using it. 

x if you do not know how to correct the error and/or want 
to start again. RMSDEF returns to the file 
specification request (Section A.4.2). 

Other errors result in one of the following messages: 


@e THIS FILE CANNOT BE CREATED 
RMS STATUS CODE = nnnnnn SYSTEM CODE = nnnnnn 


e THIS FILE CANNOT BE CREATED SINCE THE FILE ALREADY EXISTS AND 
YOU DID NOT SPECIFY SUPERSEDE. 


The RSX-11M/M-PLUS RMS-11 User's Guide defines the codes represented 
by nnnnnn. 


The utility returns to the file specification request to let you 
restart the definition process (see Section A.4.2). 


A.5 RMSDEF MESSAGES 
BAD UIC, TRY AGAIN 


Explanation: The account number in the file specification is not 
valid for your operating system for one of the following reasons: 


e Either one or both parts of the account number exceeds’ the 
maximum value allowed; the range is 1 through 377 (octal). 


e The specified account has not been set up by the = system 
manager. 


User Action: Type the file specification with a valid account 
number. 

THE DEFAULT EXTENSION QUANTITY MUST BE A MULTIPLE OF THE BUCKET SIZE 
Explanation: You typed a decimal number of blocks for default 
extension quantity, but that number is not an integral multiple 


of the bucket size you specified. 


User Action: Type the next higher multiple of bucket size for 
default extension quantity. 
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** DEVICE IS FULL ** 


Explanation: RMSDEF attempted to create the file you defined, 
but could not allocate the number of blocks you specified in the 
way you specified for one of the following reasons: 


e There exist insufficient free clusters to allocate the entire 
file. 


e There exist insufficient free contiguous clusters to allocate. 


e There is insufficient free space in the User File Directory 
(UFD) to map all allocated clusters of the file. 


e The allocation is too large for the device. 


User Action: Determine the cause of the error. The parameters 
can be altered to compensate. 


** DEVICE NOT AVAILABLE ** 


Explanation: RMSDEF attempted to create the file you defined, 
but could not access the specified device because it was not 
ready or online. 


User Action: Make the specified device ready or specify another 
device; and try again. 


DIRECTORY NOT FOUND 


Explanation: RMSDEF attempted to create the file you defined, 
but the file processor indicates that the specified account has 
not been set up. 


User Action: Specify another account number or request’ the 
system manager to create the specified account; and try again. 


ERROR IN LUN ASSIGNMENT 


Explanation: RMSDEF assigned a logical channel erroneously. 


User Action: Recall the utility and try the dialog again. 


ERROR WITH INDIRECT FILE 


FILE 


Explanation: You directed RMSDEF to read an indirect file, but 
the utility detected an error in the file that is not covered by 
other error messages. 


User Action: Recall the utility and respecify the indirect file. 


SPECIFICATION IS TOO LONG 


Explanation: You directed RMSDEF to read an indirect file, but 
the specified file contains either a file specification longer 
than 120 bytes or a line (record) longer than 80 bytes. 


User Action: Edit the indirect file, shortening the file 
specification or line. Recall the utility and specify the 
indirect file. 
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I/O ERROR IN PROCESSING INDIRECT FILE 
Explanation: You directed RMSDEF to read an indirect file, but 
the utility detected an I/O error during its processing. 


User Action: Recall the utility and respecify the indirect file. 
If this error recurs, re-create the indirect file. 


ILLEGAL DEVICE, TRY AGAIN 


Explanation: RMSDEF attempted to create the file you defined, 
but encountered an error: either the specified device is not on 
your computer system or the utility has erroneously assigned its 
logical channel to another device. 


User Action: If the device is not on your system and is not a 
logical name, specify another device and try again. 


ILLEGAL FILE SPECIFICATION, TRY AGAIN 


Explanation: RMSDEF detected a syntax error in the file 
specification. 


User Action: Retype the file specification correctly. 


ILLEGAL KEY SIZE. TYPE ? FOR HELP. 


Explanation: You typed a key size that is not valid for the key 
data type you specified. 


User Action: Type a question mark (?) to print a HELP message 
showing the size restrictions for the different data types. 
Then, type a valid key size. 


ILLEGAL VALUE. TYPE ? FOR HELP. 


Explanation: You typed a value that is not a proper reply to the 
current question or request, 


User Action: Type a question mark (?) to print a HELP message 
that should help you determine the proper values. Then type a 
prover value for the question or request. 


INVALID DATA IN COMMAND FILE 


Explanation: You directed RMSDEF to read an indirect file, but 
the a line in that file did not satisfy the utility's data 
requirements. If you specified the indirect file at command 
level, RMSDEF returns to that level. However, if you specified 
the indirect file after the utility printed its prompt, RMSDEF 
continues its dialog with you rather than the indirect file. 


User Action: Correct or re-create the indirect file and try 
again, or continue the interactive dialog. 
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KEY EXCEEDS MAXIMUM RECORD SIZE. 


Explanation: You typed a size for the key being defined which 
extends the key beyond the end of the record you defined. 


User Action: Type a smaller size or terminate the current 
session with a CTRL/Z and start again, defining a larger maximum 
record size. 


MAXIMUM NESTING DEPTH EXCEEDED IN INDIRECT FILE 


OPEN 


Explanation: An indirect command file contains an indirect 
command. RMSDEF does not permit nesting of indirect commands. 


User Action: Type the contents of one or both of the indirect 
command files as a sequence of individual command strings. 

ERROR IN INDIRECT FILE 

Explanation: You directed RMSDEF to read an indirect file, but 
the utility could not open the file. The file may not exist as 
specified; it may be locked; or there is some other problem 


with the file. 


User Action: Correct the problem and try again. 


** PRIVILEGE VIOLATION ** 


Explanation: RMSDEF attempted to create the file you defined, 
but the operating system denied the utility access. 


User Action: Correct the problem and try again. 


SEGMENTS ARE NOT ALLOWED WHEN THE KEY IS NUMERIC 


Explanation: You attempted to indicate segments for a key you 
defined as numeric (integer, binary, or packed decimal). 


User Action: Enter one size or position. 


SUM OF SEGMENTED KEY SIZES IS GREATER THAN 255. 


Explanation: You typed a series of sizes for a segmented key. 
However, the sum of those sizes is greater than 255 bytes, the 
maximum size for one key. 


User Action: Type the series of sizes again, making one or more 
of the segments smaller so that their total is 255 or less. You 
could make two keys out of the one you are attempting to define: 
reduce the segments in this key and when RMSDEF asks if you have 
more keys to define, type Y and specify another key containing 


the rest of the segments. 


SYNTAX ERROR IN INDIRECT FILE SPECIFICATION 


Explanation: You typed a file specification for an indirect 
command file, but there was a syntax error in it. 


User Action: Type the file specification correctly. 
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THE BUCKET FILL SIZE IS GREATER THAN THE ACTUAL BUCKET SIZE. 
Explanation: You typed a decimal number of bytes as a fill 
number. However, that number is greater than the total bytes in 
the bucket you specified for the current area. 

User Action: Type a fill number smaller than the bucket size. 

THE NUMBER OF VIRTUAL BLOCKS PER BUCKET IS NOT BIG ENOUGH GIVEN 

THE MAXIMUM RECORD SIZE YOU SPECIFIED. 


Explanation: You typed a bucket size that would not contain the 
largest record you indicated in the maximum record size question. 


User Action: Enter a larger bucket size; or terminate the 
utility, recall it, and redefine the file with no or a larger 
Maximum record size. 
TOO MANY AREAS 
Explanation: You typed Y in response to the question: 
DO YOU WANT TO DEFINE MORE AREAS (NO)? 
However, you have defined 255 areas, the maximum for one file. 
User Action: Continue with the RMSDEF interactive session and 
complete the file definition. 
TOO MANY KEYS 
Explanation: You typed Y in response to the question: 
DO YOU WANT TO DEFINE MORE KEYS (NO)? 
However, you have defined 255 keys, the maximum for one file. 
User Action: Continue with the RMSDEF interactive session and 
complete the file definition. 
TOO MANY SEGMENTS 
Explanation: You are defining a seaqmented key. However, the 
series of positions or the series of sizes you typed contained 


more than eight numbers, the maximum segments for one key. 


User Action: Type the number series again, using no more than 
eight values. 
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WARNING - BE AWARE THAT THE FILENAME HAS BEEN TRUNCATED. 


Explanation: In the file specification you just typed, you 
specified a file name longer than nine characters. RMSDEF 
continues the interactive session, but the utility uses only the 
maximum number of characters allowed in the file name when it 
tries to create the file. For example, you type the file 
specification: 


ACCOUNTING.DAT 
RMSDEF uses only ACCOUNTIN.DAT when it tries to create the file. 


User Action: Continue the session unless you cannot accept the 
file name truncation. 


WARNING - BE AWARE THAT THE FILE TYPE HAS BEEN TRUNCATED. 


Explanation: In the file specification you just typed, you 
specified a file type longer than three characters. RMSDEF 
continues the interactive session, but the utility uses only the 
first three characters in the file type when it tries to create 


the file. For example, you type the file specification: 
PAYDAY.FILE 
RMSDEF uses only FIL when it tries to create the file. 


User Action: Continue the session unless you cannot accept the 
shorter type. 


YOU ENTERED A DIFFERENT NUMBER OF SEGMENTS IN THE KEY POSITION 
QUESTION. 


Explanation: You are defining a segmented key. However, the 
series of key sizes you typed does not contain the same number of 
segments as the series of key positions you typed for the last 
question. 


User Action: Type the key size series again, specifying the same 
number of segments that you used in the key position series. 


YOU HAVE SPECIFIED A VIRTUAL BLOCK NUMBER WHICH IS NOT WITHIN THE 
BOUNDARIES OF THE FILE. 


Explanation: You are using virtual block number (VBN) alignment 
to place a file area other than area 0. However, the number you 
typed in response to the LOCATION: request is not a valid VBN 
for the file you have defined to this point. 


User Action: Recalculate the extent of the file you have defined 
to this point by adding the initial allocation quantities for all 
the areas defined, starting with area 0. Use the sum to help you 
type a valid VBN. 
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YOU ORIGINALLY GAVE A BAD FILE SPECIFICATION WHICH WAS OUTPUT TO YOUR 
COMMAND FILE. YOU MUST EDIT THE CHANGE IN YOURSELF. 


Explanation: When you typed a file specification for the file 
you were defining, you made an error. RMSDEF allowed you to 
retype the file specification at the end of the interactive 
session, after it failed to create the file. However, you also 
directed the utility to create an indirect file during the 
session. That indirect file now has an incorrect file 
specification at its beginning. 


User Action: Before you can use the indirect file, you must 
change the invalid file specification with a file editor. 
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RMSDES AREA DEFINITION 


One option in using RMSDES is to allow the utility to define areas by 
default. In most cases, this is the best option and will provide 
optimal area definitions. 


RMSDES bases its area calculations on the number of keys specified in 
the key section: 


e If you specify 1 key (the primary key), RMSDES will define 3 


asenanaces 


areas: 
Area 0 -- data level for primary key 
Area 1 -- level-1l index 
Area 2 -- level-2 index 


e If you specify 2 keys, RMSDES defines areas 0, 1, and 2, as 
above, plus 2 additional areas: 


Area 3 -- all index levels 
Area 4 -- data level for first alternate key 


e If you specify 3 or more keys, RMSDES defines areas 0 through 
4, as above, plus 1 new data-level area for each additional 
key specified. For example, if you specify 4 keys, RMSDES 
will define areas 0 through 4, as above, plus 2 new 
data-level areas for keys 3 and 4 (or 7 areas total). All 
index levels will be in area 3. 


Note that the data area for alternate keys contains a set of pointers 
from the alternate index to the user data records. 


In defining areas, RMSDES automatically calculates default allocation, 
bucket size, and extension values for each area. 


RMSDES calculates allocation using the maximum record number (see 
Section 2.6.2) and the record size (see Section 2.6.3). If you are 
allowing RMSDES to define areas by default, you must set these 
attributes in the file and record sections of the design buffer. 
Otherwise, RMSDES will calculate an allocation that may not be 
appropriate for your file. 


RMSDES allocation calculations also take into account whether 
duplicate key values are allowed, based on your response to the prompt 
for the average number of duplicates (see Section 2.6.5). 


RMSDES AREA DEFINITION 


- You will be prompted for bucket size when you allow RMSDES to define 
areas by default (see Section 2.6.5). You can respond with an 
explicit bucket size for RMSDES to use in defining areas, or you can 
take the default. By default, RMSDES sets bucket size to 2 blocks, or 
to a size great enough to contain 1 record if record size is greater 
than 2 blocks. 


RMSDES calculates the default extension as 5 percent of the area 
calculation, rounded to a multiple of bucket size. 
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RMS-11 COMMAND OTILITIES MESSAGES 


Section C.1 of this appendix documents error messages issued by the 
RMSBCK, RMSRST, RMSCNV, and RMSDSP command utilities. RMSIFL command 
utility messages are documented in Section C.2. Messages issued by 
the interactive utilities RMSDES and RMSDEF are documented in Chapter 
2 and Appendix A, respectively. 


The following conventions are observed in the messages documented in 
this appendix. 


Convention Meaning 


4 A question mark, appearing as the first character of a 
message, indicates a fatal error condition. When a 
fatal error condition occurs, the utility terminates 
processing at the point at which the error was 
encountered. 


% A percent sign, appearing as the first character of a 
message, indicates a nonfatal error, warning, or an 
informational message. The utility terminates 


processing of only the file causing the error. The 
utility continues processing any other files specified 
in the command string. 


s A character representing the severity level for the 
error. A severity code of F is fatal, a severity code 
of I is informational, and a severity code of W is a 
warning. 
utl The 3~character name of the utility encountering the 
error. 
<date> A date you specified within the command string. 
<device> A device specification. 


<file-spec> A file specification. 


<fipcode> A numeric value representing a file processor error 
code. When an error message contains a fipcode, refer 
to the description of the code in the error code 
appendix of the IAS/RSX-11 I/O Operations Reference 


Manual. 

<nn> A numeric value. 

<rmscode> A numeric value representing an RMS-11l error code. When 
an error message contains a code, refer to the 
description of such codes in the RMS-11 Macro 


Programmer's Guide. 


RMS-11 COMMAND UTILITIES MESSAGES 


-<status-val> A status value representing either a fipcode or detailed 
information about an operation (for example, a status 
subcode). 


<string> A command or fragment of a command. 

<switch> A switch appearing within the command string. 
<value> A switch value appearing within the command string. 
<vbn> A virtual block number. 


C.1 RMSCNV, RMSDSP, RMSBCK, AND RMSRST ERROR MESSAGES 
This section lists all RMSCNV, RMSDSP, RMSBCK, and RMSRST error 
messages. An explanation and the appropriate user action is indicated 
for each message. 
?Putl-s-ANA, Argument not allowed - <switch> 
Explanation: The specified switch does not accept arguments. 
User Action: Refer to the appropriate chapter and verify the 
usage for the switch you specified. Retype the command line. 
?utl-s-APR, File <file-spec> is not empty, /AP switch is required 


Explanation: The output file exists, the file was not empty, and 
the /SU switch was not specified. 


User Action: To supersede, specify the /SU switch. To append, 
specify the /AP switch. 
?Putl-s-BFS, Too many selective file specifications 


Explanation: More than 10 file specifications appear as values 
of the /SE switch. 


User Action: Type the command string specifying no more than 10 
file specifications as values of the /SE switch. Use multiple 
command strings to select additional files. 

?utl-s-CDE, Unable to restore special attributes for file <file-spec> 
Explanation: When RMSRST created the output file, the write 
attributes QIO failed. The utility cannot restore the file with 
one or more of the following attributes from the original file: 

@ One or more of its original data attributes 

e its original protection specification 

e cContiguity 

® Piacement control 

@ Areas 

User Action: Use the RMSDSP utility to determine which 


attributes of the file were not restored. 
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?utl-s-COR, Not enough memory available 


Explanation: Not enough memory is available in the image to 
process the files specified in the command string. This could be 
caused by one or more of the following: 


e Too many keys were specified in the output file. 
e Too many keys were specified in the input file. 


e The bucket size in either the input or output file was too 
large. 


User Action: Use a smaller bucket size or fewer keys in the 
output file. If this is not possible, copy the input file to a 
sequential file using RMSCNV and use this sequential file as 
input to RMSIFL. 


Putl-s-CRP, Output volume corrupt - <file-spec> 


Explanation: The internal structure of an RMS-1l file is 
corrupted, and RMS-11 cannot read or write records in the file. 


User Action: Move the disk pack to another device and try the 
command string again. If the utility processes the file 
normally, there was a read error on the first attempt; you 
should notify your system manager. However, if the utility 
prints this error message again, you must recreate the indicated 
files 


1. Use RMSDES to define and create a file, then use RMSIFL or 
RMSCNV to populate the new file from the corrupted one. 


2. Use the last back-up copy of the file with the RMSRST 
utility. 
?Putl-s-CSE, Syntax error <string> 

Explanation: The format of the command string does not conform 
to the syntax rules. The utility prints the command string from 
the point of the error to the end of the line. 

User Action: Refer to the appropriate utility description in 
Chapters 4 through 7. Type the command string with the correct 
syntax. 


Putl-s-CSW, Conflicting switch specified - <switch> 


Explanation: The indicated switch contradicts a previous switch 
within the same command string (scanning from left to right). 


User Action: Type the command string with the correct switch. 
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?utl-s-DOL, Device off line - <device> 


Explanation: The indicated device is on the system, but access 
is prohibited for one of the following reasons: 


e The device is not ready. 
e No volume is mounted on the device. 


e The device requires privileges for use and you do not have 
those privileges. 


e The device is disabled. 
@ The device on which the file is contained is off line. 


User Action: Correct the problem and retype the command string. 


Putl-s-DWP, Device write protected - <device> 


Explanation: The utility cannot access the device for write 
operations for one of the following reasons: 


e The device is characteristically read-only. 


e Read-only access (by file protection code or hardware/software 
write locking) is allowed. 


e On a write operation, the error IE.WER or IE.WLK may have been 
returned. 


User Action: Write-enable the device. 


S$utl-s-EOE, EOF (Control/Z) established at VBN <vbn>, byte <nn> 


Explanation: When using the RMSCNV /EO switch, if the EOF 
character (CTRL/Z) has been found, the utility displays its 
location. 


User Action: None. 


Putl-s-ESA, Incomplete output file remains - <file-spec> 


Explanation: An error has occurred which resulted in the 
Suspension of a file backup (RMSBCK) or restore (RMSRST). This 
message appears after the appropriate error message has' been 
displayed, and indicates that although the output file has been 
created, the contents are not complete. 


User Action: If possible, correct the problem and try again. 
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Sutl-s-EXC, Exception record: --reason code-- <notes> 
Explanation: An exception record has been produced by RMSCNV. 
This message will appear only if you specified the /ER switch, 
and your target output file is a record unit (terminal or 
printer) device. One of the following reason codes is listed: 
e Record out of sequence 
e Duplicate key where not allowed 
@e Record too short for primary key 
e Record too long for bucket size 
e Record doesn't fit fixed length 
e Record too long for maximum record size 


e Record contains an illegal data type 


In addition, one of the following notes may also be listed: 


= stot 
® Truncated - indicating that the the key was too large to 
display 


e Nonprinting - indicating that the key contained nonprinting 
characters, which RMSCNV changed to a "?" 


User Action: You may fix the exception records and re-run RMSCNV 
to load them. 
Putl-s-EXF, Multiple output files not allowed 


Explanation: Multiple output files are not allowed for this 
utility. 


User Action: Break the command line into several commands’ each 
having single output files. 
?Putl-s-FNA, File <file-spec> not available 


Explanation: Either the file could not be shared (for RMSDSP), 
or write access could not be obtained to process the file. 


User Action: Retry the command string until the file is 
released. 

$utl-s-FPC, Processing complete for file <file-spec> 
Explanation: The utility displayed an informational message 
indicating that the backup (RMSBCK) or restore (RMSRST) for a 


file was completed successfully. 


User Action: None. 
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?utl=s=FPL, File position lost = <fite=spec> == 9 


Explanation: An internal inconsistency was detected in the 
back-up set, and processing cannot be continued. Possible 
reasons include: 


On /RC (read check), the internal EOF was not processed 
properly. 


A rewritten VBN is out of place within the back-up file. 


A preamble (internal header) check failed, indicating that 
internal structures are in error. 


User Action: Determine from the output account or summary 
listing file the extent of the processing that was completed 
before the error occurred. Type the command string, eliminating 
specifications of files successfully processed. Use a new tape 
volume and/or a different tape drive. 


?utl-s-FQL, Output file fill quantities will not be preserved 


Explanation: When using the RMSCNV /CA (copy attributes) switch 
with multiarea indexed files that are not empty, the fill 
quantities will not be copied to the new output file. 


User Action: To preserve multiareas, use RMSDES to create them. 
Use RMSCNV or RMSIFL to populate the indexed file. 


Putl-s-FTL, Fatal RMS error; PC=<nn>, STS=<rmscode>, STV=<status-val>, 
file=<file-spec> 


Explanation: An unexpected fatal error return occurred on an 
RMS-11 operation. The error returns are octal values. 


For RMSCNV and RMSDES, this indicates that the internal error 
processor cannot identity the error code. This may indicate a 
mismatch between the version of the utility and the RMS-11 access 
methods. 


User Action: See the RMS-1l1 Macro Programmer's Guide for 
descriptions of the STS and STV codes. 


?utl-s-FTO, Illegal file specification - <file-spec> 


Explanation: The file specification does not conform to the 
syntax rules or the expanded string cannot fit within the 
internal buffer allocated. 


User Action: Type the command string with the correct syntax. 


?Putl-s-IAC, File <file-spec> is locked 


Explanation: The specified file was improperly closed the last 
time it was accessed and remains in a locked state. 


User Action: Use the /UN switch or the /EOF switch (if 
appropriate) with PIP to unlock the file (see the RSX-11M/M-PLUS 


Utilities Manual). 
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?Putl-s-IAS, Illegal use of /AP, /BL, or /SU with file organization 


Explanation: You combined one of the switches illogically with a 
file organization, as follows: 


@ /AP or /SU with @ nonsegquential file 
e /BL with a disk file 


User Action: Type the command string without the switch. 


?utl-s-IAX, Illegal use of /KN, /KR, or /LO with file organization 
Explanation: The RMSCNV /KN, /KR, and /LO switches require 
output indexed files. You specified an output file that is not 
indexed. 


User Action: You cannot use any of the switches (/KN, /KR, or 
/LO) unless the output file is indexed. 


ion <nn> 
Nhs NSLLLAS 


Explanation: This message displays the version number and patch 
level of the utility. 


User Action: None. 


Putl-s-IFL, Incorrect file organization for file <file-spec> 


Explanation: The RMSCNV /FO switch argument value does not match 
the real organization for the output file. 


User Action: Type the command string with the correct file 
organization. 

?utl-s-IKN, Missing or illegal key name argument 
Explanation: There is an error in the key name argument to the 
RMSCNV /KN switch. You specified either a key that is null, or a 
key that contains illegal characters. 
User Action: Specify RMSDSP using the /FU switch to determine 
what the key names are. 


Putl-s-IKR, Invalid /KN or /KR value 


Explanation: The key specified as the argument to the RMSCNV /KN 
or /KR switch is not defined for this input indexed file. 


User Action: Enclose the name in quotation marks if the name is 
lower case or contains spaces. 
?utl-s-IKY, Input key of reference is <nn> <key-name> 


Explanation: The utility displays this message to identify the 
key of reference for input indexed files. 


User Action: None. 
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?utl-s-ILF, Error insert too big, code= <rmscode> 
Explanation: This message indicates that either a command line 
from an indirect command file is too long, or that the parameters 
passed to the error processor exceed the provided buffer space. 
The code field contains the octal error code. 
User Action: Notify your system manager who should submit a 
Software Performance Report (SPR) documenting the conditions 
under which the error occurred. 

?utl-s-ILS, Illegal switch on input file - <switch> 


Explanation: The indicated switch is not a valid input file 
switch for the utility. 


User Action: Type the command string with the correct switch or 
without the indicated switch. 
Putl-s-INP, Multiple input files not allowed 


Explanation: You specified multiple input files for a utility 
that accepts only a single input file. 


User Action: Type the command string specifying a single input 
file. 

$utl-s-IOI, I/O error encountered on input file <file-spec> 
VBN <vbn> to <vbn>. Continue (Yes or No)? 
Explanation: The virtual blocks cannot be read from the file. 
If the file is input to RMSBCK, the utility cannot back up the 
data records within the blocks. If the file is input to RMSRST, 
the utility cannot restore the data within the blocks. 
User Action: Type "Y" if you want the utility to continue 
despite the error. Type "N" if you want the utility to 
terminate, 

?Putl-s-1I00, I/O error encountered on output file ~ <file-spec> 
Explanation: One of the following conditions exists: 
e The device is not on line. 
e The device is not mounted. 
e The hardware failed. 


e The volume is full. 


User Action: Correct the problem and retype the command string. 
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?utl-s-IOR, I/O error on command line input 
Explanation: The utility cannot read: 
e The command string you typed at the terminal 
e A line within an indirect file 
User Action: Retype the command string or recreate the indirect 
file and retry the command. 
Putl-s-I0S, Illegal output option - <switch> 
Explanation: The switch is not a valid output file switch. 
User Action: Type the command string with the correct switch or 
without the indicated switch. 
Putl-s-ISP, Illegal argument value - <value> 


Explanation: The value specified in the switch is either null, 
the incorrect data type, or inappropriate for the specific file. 


User Action: Type the command string with the correct switch 
value. 
?Putl-s-ISS, Illegal switch specified - <switch> 


Explanation: You specified a switch that the utility does not 
recognize. 


User Action: Retype the command string correctly. 


?utl-s-IWC, Illegal use of wildcards on input file 


Explanation: The utility does not permit wildcard characters 
(asterisks) in an input file specification. 


User Action: Type the command string without wildcard characters 
in the input file specification. 

?Putl-s-IWF, Illegal use of /WF with record format 
Explanation: You specified the /WF switch in an RMSCNV- command 


string, but neither the input nor the output file contains 
variable-with-fixed-control (VFC) records. 


?utl-s-LSW, Illogical switch in context of command - <switch> 
Explanation: Either the switch appears multiple times on the 
command line, or the specified switch does not have any meaning 
with the files being processed. 


User Action: Type the command string with appropriate switches. 
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?utl-s-LUN, TI: LUN assignment error 


Explanation: An attempt to assign the terminal LUN for command 
line and error text processing has failed. 


User Action: Notify your system manager who should submit a 
Software Performance Report (SPR) documenting the conditions 
under which the error occurred, 


?utl-s-MDE, Command file nesting depth exceeded 


Explanation: An indirect command file contains an indirect 
command. RMS-11 does not permit nesting of indirect commands. 


User Action: Type the contents of one or both of the indirect 
command files as a sequence of command strings. 


?Putl-s-MLE, Block value of /ML switch exceeds limit or available 
memory 


Explanation: The RMSCNV /ML (memory limitations) switch 
specifies a numeric argument which is not in the allowable limit 
(0-63 for image copy), or specifies allocation of more memory 
than is available to the task image. 


User Action: Reenter the command line specifying a smaller value 
for the /ML switch. 


?utl-s-MLF, Read error or inconsistent data. May have lost files. 


Explanation: The utility encountered an error while reading a 
back-up or container file. 


User Action: Retry the command string, specifying the /RC 
switch. If the error recurs, determine, from the summary listing 
produced when the back-up or container file was created, which 
files cannot be completely restored. If you have other back-up 


copies of these files, use them with the command. 


?utl-s-MMQ, Mismatched quotes <string> 


Explanation: An odd number of quotation characters is present on 
the command line. Quotation characters must be used in pairs. 


User Action: Determine where the unpaired quote is in the 
command line and either remove it or place the second quote in 
the appropriate place. Reenter the command line. 


?Putl-s-MOV, Missing option value -—- <switch> 


Explanation: You did not supply a value with the indicated 
switch. 


User Action: Type the command string specifying a value for the 
indicated switch. 


RMS-11 COMMAND UTILITIES MESSAGES 


Putl-s-MRS, Input and output record sizes do not correspond 


Explanation: The input and output record sizes do not 
correspond. Typically, this is due to the output file being 
fixed format, and the input MRS (fixed or variable size) not 
matching the output MRS (fixed size). 


User Action: You may need to specify the /PD and/or /TR 
switches. This will allow RMSCNV to pad short records and/or 
truncate long records to conform to the output MRS. 


?Putl-s-MSF, Output file specification required 


Explanation: You did not provide an output file specification on 
the command line, when one was expected and required. 


User Action: Supply an output file specification that output 
records can be written to. The device is utility-specific (see 
the appropriate chapter) and may be restricted to a certain 
category. 


Putl-s-NBK, Input file <file-spec> is not container file 


Explanation: The utility requires the input file to be a back-up 
file. You have specified a file that is not in back-up format. 


User Action: Type the command string with the correct file 
specification. 

?Putl-s-NDM, Explicit container filename necessary 
Explanation: The output file must be an explicit file 
specification. No wildcard file name and type fields are 
allowed. 
User Action: Retype the command line providing an explicit file 
specification. 

Putl-s-NRN, No rename allowed 
Explanation: During backup (RMSBCK) or restore (RMSRST) of 
disk-based back-up files, the file specifications of the output 
files were not wildcarded. RMSBCK and RMSRST output file name 
and type fields must be wildcarded if the medium is disk. 
User Action: Type the command string specifying wildcards for 
the name and extension components of the output file. 


?Putl-s-NSD, Not a shareable device - <device> 


Explanation: The command string you typed requires the sharing 
of a nonshareable device. 


User Action: Type the command string with a correct device 
specification. 
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Putl-s-OOA, Output file will contain only one area 
Explanation: The file used as input to the RMSCNV /CA switch (or 
the input file if no argument was specified to the /CA switch) 
contained multiple areas. 
User Action: If the output indexed file is to contain multiple 
areas, use RMSDES to define and create the file. Then, use 
RMSCNV or RMSIFL to populate it. 

?utl-s-OPR, Failure to open command file 
Explanation: An I/O or file system error, such as a privilege 
violation, an attempted write operation to a locked unit, or a 
Parity error occurred when the utility attempted to open an 


indirect command file. 


User Action: Correct the problem and retry the command string. 


Putl-s-OWC, Illegal use of wildcards on output file 


Explanation: The utility does not permit wildcard characters 
(asterisks) in the output file specification. 


User Action: Type the command string without wildcard characters 
in the output file specification, 
?Putl-s-PRV, Privilege violation on file <file-spec> 


Explanation: You do not have the privileges necessary to access 
the indicated file. 


User Action: Ask the owner of the file to change the protection 
code, or use the utility from a more privileged account. 
?utl-s-RAE, Error reading attributes for file <file-spec> 


Explanation: This message results from one of sveral possible 
errors: 


e An inconsistency in the preamble of a back-up file 
e An error attempting to read the attributes of a back-up file 


e An error reading the preamble of a new back-up file on _ the 
RMSBCK /RC (read check) pass 


e A mismatch between the copied data and the original file on 
the RMSBCK /RC (read check) pass 


User Action: Use RMSDSP to determine the file's protection: 
e If you are forbidden access to the file by its protection 
code, request that its protection be changed or use a more 


privileged account. 


e If you are allowed access to the file by its protection code, 
use the VFY utility to check the volume for corruption. 
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?utl-s-RAM, Required argument missing - <switch> 


Explanation: You did not provide an argument value for the 
switch you specified. 


User Action: Retype the command line and provide an argument 
value for the switch. 


Zutl-s-RCE, Read after write error on output file <file-spec>, 
VBN <vbn> to <vbn>. Continue (Yes or No)? 


Explanation: During data integrity checking, the utility 
encountered a read error while attempting to read virtual blocks 
vbnl through vbn2 of the indicated file. 


User Actions Type "Y" if you want the utility to stop processing 
the indicated file, but process the rest of the command string. 
Type "N" if you want the utility to stop processing the command 
string. 


Putl-s-RCR, Release core error 


Explanation: The utility's internal dynamic memory has_ been 
corrupted. 


User Action: The utility finished processing the current command 
string. If you want to continue using the utility, you should 
terminate it with CTRL/Z (if necessary) and then reinvoke it. 


Sutl-s-REC, <string> 


Explanation: This message is displayed after the EXC message and 
when the RMSCNV /ER switch is selected and the exception record 
device is unit oriented (terminal or printer). The message 
displays the contents of the key section of the record that 
caused the error. If the minimum record size (based upon the key 
positions and sizes) is larger than 68 characters for terminals 
or 120 characters for line printers, the EXC message will 
indicate that the record fragment was truncated. If nonprinting 
characters are present, the EXC message will also indicate this, 
and the nonprinting characters will be replaced by "?" 
characters. 


User Action: None. 


?Putl-s-RET, Read error, integrity check table and rewrite data may 
have been lost 
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internal rewrite table of the current back-up file. This can 
occur on a RMSBCK verification of the output file, or a RMSRST 


read of the rewrite table. 


User Action: Retry the command string, specifying the /RC 
Switch. If the error recurs, determine, from the summary listing 
produced when the back-up or container file was created, which 
files cannot be completely restored. If you have other back-up 
copies of these files, use them with the command. 
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?utl-s-RLG, Error in prologue of file <file-spec> 
Explanation: The utility detected an error in the prologue of 
the relative or indexed file. 
User Action: This file may be corrupt; the prologue may contain 
invalid data. This implies that the file must be recreated. 
?utl-s-RPL, Error reading prologue of file <file-spec> 


Explanation: An error occurred when RMS-11 attempted to read and 
verify the prologue of a relative or indexed file. 


User Action: Determine if the hardware is at fault (for example, 

if there are read errors). If the hardware is not at fault, the 

prologue may be corrupt and the file may have to be recreated. 
?utl-s-RSM, Required file specification(s) missing 


Explanation: You entered a command string with either an input 
or output file specification missing. 


User Action: Retype the command string with both input and 
output file specifications. 
?utl-s-RWC, Error during wildcard lookup <file-spec>. Code=<fipcode> 


Explanation: A wildcarding directive failed. The code field 
contains the octal error code returned by the executive. 


User Action: Determine if the device is at fault (hardware 
errors), or verify that the directory is intact. Retry the 
command line. 

?Putl-s-RWE, Rewind or space error on file <file-spec> 
Explanation: While processing a magnetic tape, either an illegal 
operation was attempted or the device returned a device 
positioning error. 
User Action: Retry the command string. If the condition recurs, 
mount the volume on another drive and retry the command string. 


Putl-s-SLT, Select error - <device> 


Explanation: The magtape specified in the device field of the 
file specification is not accessible. It is probably off line. 


User Action: Correct the problem and retype the command string. 
Putl-s-SLW, Wildcards not permitted in summary listing file 

specification 

Explanation: You used asterisks in a file specification as the 

argument of an /SL_ switch. RMS-11 does not permit wildcard 


characters in this context. 


User Action: Type the command string without wildcard characters 
in the summary listing file specification. 
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?utl-s-SSO, Illegal use of /EO with organization or record format 


Explanation: You attempted to use the /EO {(end-of-file) switch 
on a file that was not sequential organization with stream record 
format. The file is not acceptable input for /EO processing. 


User Action: None. 


S$utl-s-TER, Integrity check table full. Continue (Yes or No)? 


Explanation: The table, allocated internaliy by the utility to 
monitor input read errors, exceeded its capacity. The file or 
volume can be assumed to be either corrupt, or produce too many 
errors for the back-up data to be considered intact. This 
suggests hardware faults. 


User Action: Type "Y" to continue processing. Type "N" to 
terminate processing. Also, check the system error log, or clean 
the (tape) device or unit. 


?Putl-s-TMP, Error processing temporary file. Code= <fipcode> 


Explanation: The wildcard processor called by the utility 
encountered an error while creating a temporary file for 
resolution of wildcards in a file specification. The code field 
contains the octal error code. 


User Action: Type successive command strings to achieve the 
result wildcards would produce. 


Putl-s-TNF, No EOF (Control/Z) found in file 


Explanation: The RMSCNV utility could not find the CTRL/Z 
character in the sequential stream file specified with the /EO 
switch. The data within the file remains unaltered. 


User Action: None. 


?Putl-s-TOO, Command line too long 


Explanation: The command string you typed is longer than the 
utility's command string buffer (158 characters). Therefore, you 
have typed too many continuation lines. 


User Action: Use several command strings to perform the 
functions of the original command string. If the condition 
occurs repeatedly, notify your system manager who should submit a 
Software Performance Report (SPR). 


?Putl-s-TPM, Switch /TR or /PD or both are needed for this CONVERT 


Explanation: The record sizes of the files being processed by 
RMSCNV are not compatible. 


User Action: Refer to Chapter 4 for the use of the /TR and /PD 
switches. Then, retype the command string using one or both of 
the switches. 
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?utl-s-UER, Uncorrectable error, VBN <vbn> to <vbn>, reason= <reason>> 


Explanations Uncorrectable errors have been detected by the 
RMSBCK or RMSRST utility. This message indicates the cause of 
the problem, and the range of virtual blocks involved. The 
message is one of the following: 


Read check error 
Write check error 
Input error 
Output uncheckable 
User Action: Record the ranges of erroneous virtual blocks in 
the file and notify your system manager. 
Putl-s-UIC, Destination UICS may only be [*,*] or [X,Y] 


Explanation: You typed an output file specification with an 
invalid account number. 


User Action: When specifying wildcarded UICs, both the group and 
member fields must be wildcards. Either both group and member 
fields are wildcarded, or neither one can be. 


Putl-s-UIF, CNV internal fault 


Explanation: An internal error was detected by the RMSCNV 
utility. 


User Action: Notify your system manager who should submit a 
Software Performance Report (SPR) documenting the conditions 
under which the error occurred. 


?utl-s-UTL, Utility input error 


Explanation: An internal initialization error occurred during 
the execution of the indicated utility. 


User Action: Retype the command string. If the condition 
recurs, notify your system manager who should submit a Software 
Performance Report (SPR) documenting the conditions under which 
the error occurred. 


Putl-s-VFC, Input and output fixed control header sizes do not 
correspond 


Explanation: You attempted to write records from one file to 
another. Both files contain variable-with-fixed-control (VFC) 
records, but the sizes of the fixed areas are different. This is 
not allowed when using the /WF (write fixed headers) switch. 


User Action: Redefine the output file and retype the command 
string. 
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Putl-s-WAE, Error writing attributes of file <file-spec> 


Explanation: The volume is corrupted or you do not have the 
necessary privileges to write to the file. 


User Action: Verify access to file. 


Putl-s-WCD, Error with wildcards 


Explanation: The wildcard processor returned an error to. the 
utility during resolution of wildcards in a file specification. 


User Action: Type the command string again. If the condition 
recurs, use successive command strings to achieve the result 
wildcards would produce. 


Sutl-s-WCE, Check after write error on output file <file-spec>, VBN 
<vbn> to <vbn>. Continue (Yes or No)? 


Explanation: This diagnostic error message is displayed on your 
terminal if query mode is enabled and the /RC switch (check after 
writing) is specified. During data integrity checking, the 
utility found that the contents of virtual blocks vbnl through 
vbn2 in the indicated output file are not identical to the 
associated virtual blocks of the input file. 


User Action: Type "Y" to continue processing despite the error. 
Type "N" to terminate processing of the indicated output file and 
bypass the processing of any remaining files. 


?utl-s-WET, Write error on integrity check table on output file <file-spec> 


Explanation: The utility cannot write internal data integrity 
checking tables in the output back-up file. 


User Action: If the output medium is magnetic tape, use a 
different tape volume and retry the command string. If the 
output medium is disk, rename the output file so that the utility 
will not attempt to use the space, and retry the command string. 


C.2 RMSIFL ERROR MESSAGES 


This section lists all RMSIFL error messages. An explanation and the 
appropriate user action is indicated for each message. 


?IFL -- Block I/O read error on <file-spec> 


Explanation: RMSIFL could not read the index bucket from the 
output file. 


User Action: Retype the command string. If the error recurs, 
check with your system manager to see if there have been other 
errors reported for that device. If not, move the file to a 
different disk or specify a different device for the file and 
retry the operation. 


PIFL 


?IFL 


P?IFL 


?LFL 


?IFL 


RMS-11 COMMAND UTILITIES MESSAGES 
-- Block I/0 write error on file <file-spec> 
Explanation: RMSIFL could not write a block to the output file. 
User Action: Retype the command string. If the error recurs, 
check with your system manager to see if there have been other 
errors reported for that device. If not, move the file to a 


different disk or specify a different device for the file and 
retry the operation. 


-- Close error on <file-spec> 


Explanation: The specified input or output file could not be 
properly closed. 


User Action: Retype the command string. If the error recurs, 
run a validity check of the file structure using the VFY utility 
on the volume to determine whether it is corrupted. 


-- Command file nesting depth exceeded 


Explanation: An indirect command file contains an indirect 
command. RMS-11 does not permit nesting of indirect commands. 


User Action: Type the contents of one or both of the indirect 


command files as a sequence of command strings. 


-~- Create error on <file-spec> 


Explanation: The specified file could not be created by RMSIFL. 
This condition can occur for one of the following reasons: 


® The /ER switch was specified on the command line and RMSIFL 
could not open the Exception Record file. 


e RMSIFL could not create the alternate key temporary file. 


@ RMSIFL could not create the temporary file into which to write 
the sorted records from SORT. 


User Action: 


e Check the file svecification that you supplied with the /ER 
switch to be sure that it is a legal file specification. 


e Check the available space on the disk and make sure that there 
is enough space to create the files. Refer to Chapter 3 for 
file size calculations. 


e If the error occurred on a work file used in RMSIFL sorting, 
retype the command line specifying the /DE switch to assign 
the temporary work files to another device. 


-- Error terminated input before expected, but continuing 


Explanation: RMSIFL encountered a read error in the input £ 


la 
RMSIFL will finish processing with as many records as it was able 
to read from the input file. 


User Action: The input file cannot be read. Retry the cperation 
using the last back-up version of the file. 


?IFL 


7IFL 


?IFL 


?IFL 


7IFL 


71FG 


RMS-11 COMMAND UTILITIES MESSAGES 


-- Error with logical unit device 
Explanation: RMSIFL assigned a logical channel erroneously. 


User Action: Invoke RMSIFL again and retype the command line. 
If this message recurs, submit a Software Performance Report 
(SPR). 


-- Extend error on output file <file~spec> 


Explanation: The output file you provided was not large enough 
to contain the input records, or a temporary file could not be 
extended. RMSIFL explicitly extended the file, but the operation 
failed. 


User Action: Determine why the file could not be extended (such 
as, disk full). Allocate a larger output file or use a different 
output disk, and type the command string again. 

-- Failure to open command file 

Explanation: An I/O or file system error, such as a privilege 
violation, an attempted write operation to a locked unit, or a 
Parity error occurred when RMSIFL attempted to open an indirect 


command file. 


User Action: Correct the problem and retry the command string. 


-- Fatal RMS error - STS = <rmscode>, STV = <rmscode> 


Explanation: A fatal error occurred in the RMSIFL interface with 
RMS-11 file and record handling routines. 


User Action: See the RMS-11 Macro Programmer's Guide for 
descriptions of the STS and STV codes. 


-- File access error on <file-spec> 

Explanation: The specified file could not be accessed. 

User Action: Check to be sure that the file specifications that 
you supplied are legal file specifications and that the input and 
output files exist. 

-- Illegal device <device> 


Explanation: The device does not exist. 


User Action: Type the command string with a correct device 
specification. 


RMS-11 COMMAND UTILITIES MESSAGES 


?IFL -- Input and output fixed length record sizes unequal 
Explanation: The input and output files both have fixed-length 
records, but the sizes are different. One of the following 
conditions exists: 

e The output file's maximum record size is less than the input 
file's maximum record size, and the /TR switch was not 
specified on the command line. 

e The output file's maximum record size is greater than the 
input file's maximum record size, and the /PD switch was not 
specified on the command line. 

User Action: You must specify either the /PD or /TR switch in 

the command string. 


?IFL -- Input file is not sequential, relative, or indexed 


Explanation: RMSIFL requires an input file of sequential, 
relative, or indexed file organization. 


User Action: Retype the command string specifying a valid file. 


?IFL -- Input file switch specified with output file switch 


Explanation: The switch you specified on the output side of the 
command line is only valid as an input file switch. 


User Action: Retype the command string correctly. 


?IFL -- Invalid /KR value 


Explanation: You specified a key of reference greater than or 
equal to the number of keys in the input file. 


User Action: Retype the command line specifying a valid key of 
reference number. 

?IFL -- I/O error on command line input 
Explanation: RMSIFL cannot read: 
e The command string you typed at the terminal 
e A line within an indirect file 
User Action: Retype the command string or recreate the indirect 
file and retry the command. 

?PIFL -- /KR not allowed for sequential or relative file 
Explanation: The /KR switch is permitted for indexed files only. 
You either specified the wrong file or used the /KR switch in the 
wrong context. 


User Action: Type the command string with the correct file 
specification or without the /KR switch. 


eLPG 


P?IFL 


?IFL 


?IFL 


SLE 


?PIFL 


?IFL 


RMS-11 COMMAND UTILITIES MESSAGES 


-- Memory exhausted 


Explanation: Not enough memory is available in the image to 
process the files specified in the command string. 


User Action: Consult your system manager for details on 
increasing the available memory for RMSIFL. 
-- Missing file specification 


Explanation: You entered a command string with either an input 
or output file specification missing. 


User Action: Retype the command string with both input = and 
output file specifications. 
-- Output file fixed record size too large for bucket size 


Explanation: You specified a fixed-record size in an indexed 
output file that is larger than the bucket size. 


User Action: Create a new output file with either a larger 
bucket size or a smaller record size. 

-- Output file must be empty 

Explanation: The output file you specified contains data. 


User Action: Recreate the output file. 


-- Output file must be an indexed file 


Explanation: You specified a sequential or relative file as an 
output file. 


User Action: Specify or create another indexed output file. 


-- Output file switch specified with input file switch 


Explanation: The switch you specified on the input side of the 
command line is only valid as an output file switch. 


User Action: Retype the command string correctly. 


-- Prologue version number too high 


Explanation: RMSIFL opened an RMS=11 indexed file and checked 
the version number of the file's prologue. That number indicates 
that the file was created with attributes that RMS-11 cannot 


handle. 


User Action: Recreate the file using a newer version of RMSIFL 
Or RMSCNV or write an application program using the latest RMS-11 
software. 


“PIFL 


?IFL 


?IFL 


?IFL 


RMS-11 COMMAND UTILITIES MESSAGES 


-- Read error on filespec 
Explanation: RMSIFL could not read the sorted records. 


User Action: Retry the command string. If the error occurred on 
an input file and the error persists, check with your system 
manager to see if there have been other errors reported for that 
disk. If there have not been any errors, then move the disk to 
another device and retry the command string. If RMSIFL processes 
the file normally, a read error occurred in the first two 
attempts. However, if the error occurs again, you must’ recreate 
the indicated file as follows: 


1. Use RMSDES to define and create a file, then use RMSIFL or 
RMSCNV to populate the new file from the corrupted one. 


2. Use the last back-up copy of the file with the RMSRST 
utility. 


If the error occurred on a work file used in RMSIFL sorting, use 
the /DE switch to assign the work file to another device. 


-- Read error on file prologue <file~spec> 


Explanation: RMSIFL cannot read the prologue of the indicated 
file. RMSIFL bypasses the file and continues processing. 


User Action: Type the command string specifying only the 
indicated file. If the error recurs, move the disk pack to 
another device and try the command string again. If RMSIFL 
processes the file normally, a read error occurred on the first 
two attempts. However, if RMSIFL prints this error message 
again, you must recreate the indicated file as follows: 


1. Use RMSDES to define and create a file, then use RMSIFL or 
RMSCNV to populate the new file from the corrupted one. 


2. Use the last back-up copy of the file with the RMSRST 
utility. 
-- SORTS error code in octal: <nn> 


Explanation: The sort routines in RMSIFL encountered an error; 
mn is a sort error code. 


User Action: Refer to Appendix D for a description of the 
indicated error code. Correct the problem and retype the command 
string. 


-- Syntax error 


Explanation: The format of the command string does not conform 
to the syntax rules, 


User Action: Refer to the appropriate RMSIFL description in 
Chapter 3. Type the command string with the correct syntax. 


RMS-11 COMMAND UTILITIES MESSAGES 


?IFL -- /TR and/or /PD required with fixed length output records 
Explanation: The record size for the input file is different 
from the record size for the output file and may require 
truncating (/TR) and/or padding (/PD). 

User Action: Retype the command string specifying /PD and/or 
JTRs 
?IFL -- Undefined GCML error 


Explanation: An unknown error occurred during the processing of 
the command line. 


User Action: Retype the command line. If the error recurs, 
submit a Software Performance Report (SPR). 


If the error occurred while RMSIFL was processing an indirect 
command file, try the commands interactively. 
?PIFL -- Unknown switch <switch> 


Explanation: You specified a switch that RMSIFL does not 
recognize. 


User Action: Retype the command string correctly. 


?IFL -- Write error on filespec 


Explanation: RMSIFL could not write the sorted records to the 
file. 


User Action: Retype the command string. If the error persists, 
use the /DE switch and assign the file to a different device. 


APPENDIX D 


SORT ROUTINE ERROR CODES 


When the sort routines used by RMSIFL detect an error, they return one 
of the nonzero, octal codes listed below. 


Error 
Code (Octal) 


00 
01 
02 
03 
04 


05 


06 


12 


13 


14 


15 


16 


17 


20 


21 


22 


23 


Meaning 


No errors 


Device output error 
OPEN (IN) failure 
OPEN (OUT) failure 


Size of current record is greater than maximum 
size 


Not enough work area 

Key size is not positive (the sort routines 
detected a zero or negative key size in the 
calling parameter) 

Record size not positive 

Key address is not even (the keys must start at an 
even address because the sort routines use word 
moves) 

Record address is not even 

Scratch records will be too large (the size of the 
keys plus the size of the largest record must be 
less then 37776 octal) 


Too few scratch files are given (a minimum of 3 
scratch files must be specified) 


Too many scratch files are given (a maximum of 10 
scratch files may be specified) 


End-of-string record was detected where none was 
expected 


Unexpected end-of-file 


Record larger than expected 


/[NO]CV switch 
RMSRST utility, 
/{(NO]QU switch 
RMSBCK utility, 
6-10 
RMSRST utility, 
7-12 
/AP switch 
RMSCNV utility, 
4-13, 4-15 
/BD switch 
RMSRST utility, 
/BL switch 
RMSCNV utility, 
/BP switch 
RMSDSP utility, 
/CA switch 
RMSCNV utility, 
/CD switch 
RMSBCK utility, 
/DE switch 
RMSIFL utility, 
3-14 
7/EO switch 
RMSCNV utility, 
/ER switch 
RMSIFL utility, 
/FO switch 
RMSCNV utility, 
/ER switch 
RMSRST utility, 
/EU switch 
RMSDSP utility, 
/ID switch 
RMSBCK utility, 
RMSCNV utility, 
RMSDEF utility, 
RMSDSP utility, 
RMSIFL utility, 
RMSRST utility, 
7IM switch 
RMSCNV utility, 
/KN switch 
RMSCNV utility, 
/KR switch 
RMSCNV utility, 
RMSIFL utility, 
/LO switch 
RMSCNV utility, 
/MA switch 
RMSCNV utility, 
/ML switch 
RMSCNV utility, 
/NOER switch 
RMSIFL utility, 
/NOSO switch 
RMSIFL utility, 
/OA switch 


7-5, 7-10 
6-5 to 6-7, 
7-6 to 7-8, 
4-5, 4-7, 
7-8, 7-10 
4-8 

5-3 to 5-4 
4-8 


5-2, 5-4 

6-4 to 6-5 
4-5, 4-9 

A-5 
5-3, 
3-3, 
7-3, 


5-5 
3-5 
7-5 


4-10, 4-16 
3-8 to 3-9 


4-10 
3-6 


3-8 to 3-10 


INDEX 


RMSRST utility, 
/PD switch 
RMSCNV utility, 
RMSIFL utility, 
3-11 
/RA switch 
RMSBCK utility, 
6-9 
RMSRST utility, 
/RC switch 
RMSBCK utility, 
RMSRST utility, 
/7RD switch 
RMSBCK utility, 
/RW switch 
RMSBCK utility, 
/SE switch 
RMSRST utility, 
/SL switch 
RMSBCK utility, 
RMSCNV utility, 
RMSRST utility, 
/SU switch 
RMSBCK utility, 
RMSCNV utility, 
4-13, 4-15 
RMSRST utility, 
7/TR switch 
RMSCNV utility, 
RMSIFL utility, 
/WE switch 
RMSCNV utility, 


Alignment 
RMSDEF utility, 
ALLOCATION 
RMSDES utility 
area section, 
file section, 
Allocation 
RMSDEF utility 
data, A-16 
file, A-14 
RMSDES utility 
areas, 2-10, 2 
RMSDSP 
displaying, 5- 
Alternate index 
3-11 to 3-12 
Alternate key 
RMSDEF utility 
defining, A-1l 
RMSIFL utility 
allocating fil 
sorting, 3-11 
Alternate key file 
device allocatio 
ANSI-standard tape 
RMSBCK utility, 


Index-l 


7-9 to 7-10 
4-12 

3-6 to 3-7, 
6-6 to 6-7 ta 


7-7, 7-11 


-25 


4 


(RMSIFL), 


e space, 3-13 


s (RMSIFL) 
Ny, 3-7 


6-1, 6-8 


INDEX 


RMSDSP.-utility, 5-3. key section, 2-38 
Area information, displaying, NULL KEY, 2-39 
5-4 NULL VALUE, 2-39 


Area numbers (RMSDEF), A-16 


Areas 
RMSDEF utility 


defining, A-13 


RMSDES utility, 2-10, 2-25 


defining, 2-1, 2-42 
and BUCKET SIZE attribute, 


2-32 

and DATA AREA attribute, 
2-40 

and INDEX AREA attribute, 
2-41 


and LEVEL1 INDEX AREA 
attribute, 2-41 

and SIZE attribute, 2-36 

by default, 2-43 

explicitly, 2-43 
defining by default, 2-17, 

2-38 

CREATE command, 2-8, 2-28 

SET ALL command, 2-14 
defining explicitly, 2-17 
numbering, 2-8, 2-28, 2-43 


ASCII stream files 
RMSCNV utility, 4-3, 4-8 
RMSIFL utility, 3-1 
Attributes 
RMSDES utility, 2-29 


ALLOCATION 

area section, 2-44 

file section, 2-31 
BLOCK SPAN, 2-37 
BUCKET SIZE 

area section, 2-43, 2-45 

file section, 2-32 
CARRIAGE CONTROL, 2-37 
CHANGES, 2-40 
CLUSTER SIZE, 2-31 
CONTIGUOUS 

area section, 2-46 

file section, 2-35 
CONTROL FIELD SIZE, 2-37 
DATA AREA, 2-40 
DATA FILL, 2-40 
DUPLICATES, 2-40, 2-42, 2-44 
EXACT POSITIONING, 2-47 
EXTENSION 

area section, 2-45 

file section, 2-32 
FILE PLACEMENT 

system section, 2-30 
FORMAT, 2-36 
INDEX AREA, 2-41 
INDEX FILL, 2-41 
informational, 2-29 
LEVEL] INDEX AREA, 2-41 
MAGTAPE BLOCK SIZE, 2-34 
MAX RECORD NUMBER, 2-34 
NAME = 

file section, 2-31 


ORGANIZATION, 2-31 
OWNER, 2-34 
POSITION, 2-46 
PROTECTION, 2-33 
REWIND MAGTAPE, 2-34 
RMS-1l1, 2-29 
SEGO POSITION, 2-42 
SEGn LENGTH, 2-42 
SEGn POSITION, 2-42 
SIZE, 2-36 
SOURCE, 2-30 
SUPERSEDE, 2-35 
TARGET, 2-30 
TYPE, 2-38 
RMSDSP, 5-1 
Attributes (RMSDES) 
clearing, 2-6, 2-22, 2-25 
individual values, 2-26 
sections, 2-26 
displaying, 2-15, 2-26 
individual values, 2-26 
sections, 2-27 
informational, 2-1, 2-17 
resetting, 2-21 
RMS-11, 2-1, 2-17 
setting, 2-13 
from a data file, 2-25 
from a description file, 
2-24 
individual values, 2-21 
setting sections, 2-21 


Back-up date, file 
RMSRST utility, 7-8, 7-10 
Block boundaries 
RMSDEF utility, A-9 
Block mode 
RMSCNV utility, 4-1 
BLOCK SPAN 
RMSDES utility, 2-37 
Bucket size 
RMSDEF utility, A-15 
BUCKET SIZE 
RMSDES utility 
area section, 2-43, 2-45 
file section, 2-32 
Buckets 
RMSCNV utility, 4-10 


Calculating file work space 

(RMSIFL), 3-12 
Carriage control 

RMSDEF utility, A-9 
CARRIAGE CONTROL 

RMSDES utility, 2-37 
CHANGES 

RMSDES utility, 2-40 
CLEAR command 

RMSDES utility, 2-6, 2-18, 

2-25 to 2-26 


Index-2 


INDEX 


defining areas by default, 
2-44 
in indirect command file, 


2-4 
PROTECTION attribute, 
2-8, 
2-27 
Clearing attributes 


with 
with 


CREATE, 
SAVE, 


2-33 
2-28 


(RMSDES) 


See Attributes, clearing 
CLUSTER SIZE 


RMSDES 


utility, 


Command file 


RMSDEF 


VeTLIcy, 


Command string 


RMSBCK 
RMSCNV 
RMSDEF 
RMSDSP 
RMSIFL 


utility, 
utility, 
utility, 
utility, 
utility, 


2-31 


to 6-3 
to 4-4 


to 
to 


RMSRST utility, 
Command string che 
3-9 
Command utility 
messages, C-l 
Commands 
RMSDES utility, 2-1, 2-4 
See also individual command 


6 
4 
A 
5 5-3 
3 3-3 
7-2 to 7-3 
cking (RMS 


entries 
See also RMSDES 
Compression 
RMSIFL utility, 3-11 
Container file 
RMSBCK utility, 6-1, 6-3, 6-7 
RMSDSP 
detailed display, 5-4 
RMSDSP utility, 5-1, 
5-3 to 5-4 
RMSRST utility, 7-3, 
7-9 to 7-10 
Contiguity 
RMSCNV utility, 4-2 
RMSDEF utility, A-15 
RMSIFL utility, 3-1, 3-6 
CONTIGUOUS 
RMSDES utility 
area section, 2-46 
file section, 2-35 
CONTROL FIELD SIZE 
RMSDES utility, 2-37 
CREATE command 
RMSDES utility, 2-7, 2-18, 
2-28, 2-31 
defining areas by default, 
2-44 
defining areas explicitly, 
2-43 
INDEX AREA attribute, 2-41 


key numbering, 2-38 
LEVEL1 INDEX AREA 
attribute, 2-41 
setting attributes, 
with GET, 2-10, 2-25 
Creating files 


2-21 


RMSDEF utility, A-19 
See also Data file (RMSDES) 
Creation date, fil 
RMSBCK utility, 
CTRL/Z 
RMSBCK 
RMSCNV 
file 
RMSDES 
RMSDSP 
RMSIFL 
RMSRST 


6-8 


utility, 6-2 
utility, 4-4 
terminator, 

utility, 2 
utility, 5-2 
utility, 3-2 
utility, 7-2 


4-8 


, 2-9, 2-18 


Data file 
RMSDES utility, 
2-24 
creating, 2-3, 2-7, 
GET command, 2-10 
Data integrity checking 
RMSBCK utility, 6-6 to 6-7, 
6-9 
RMSRST utility, 7-11 
data integrity checking 
RMSRST utility, 7-6, 
DATA AREA 
RMSDES utility, 
DATA FILL 
RMSDES utility, 
Default extension 
RMSDEF utility, 
Defaults 
RMSDES utility, 
Description file 
RMSDES utility, 
2-17, 2-24 
EXIT command, 
GET command, 
SAVE command, 
Design buffer 
RMSDES utility, 2-1 
Design buffer (RMSDES) 
using, 2-16 
Design buffer sections 
See Sections 
Design session 
RMSDES utility, 
resuming, 2-22 
Display information (RMSDSP), 
5-1 
Displaying allocation information 
RMSDSP utility, 5-4 
Displaying area information 
RMSDSP utility, 5-4 
Displaying attributes (RMSDES) 
See Attributes 
Displaying indexed file attributes 
RMSDSP utility, 5-4 
Displaying key information 
RMSDSP utility, 5-4 
Displays (RMSDSP), 5-5 
DUPLICATES 
RMSDES utility, 
area section, 


2-28 


-” 


7-8 
2-40 
2-40 
quantity 
A-15 
2-21 
2-3, 2-13, 
2-10 


2-10 
2-27 


(RMSDES) 


2-1 


2-40, 
2-44 


2-42 


Index-3 


INDEX 


“Error codes (RMSIFL) ~~ 2-24 
sort routine, D-l PROTECTION attribute, 2-33 
ESC command with SAVE, 2-28 
RMSDES utility, 2-9, 2-21 Global switches 
EXACT POSITIONING RMSBCK utility, 6-5 
RMSDES utility, 2-47 RMSIFL utility, 3-5 
Examples RMSRST utility, 7-5 
RMSBCK utility, 6-10 
RMSCNV utility, 4-16 HELP 
RMSDES utility, 2-47 RMSBCK utility, 6-4 
RMSIFL utility, 3-14 RMSCNV utility, 4-5 
RMSRST utility, 7-12 RMSDEF utility, A-5 
Exception codes RMSDES utility, 2-2, 2-11 
RMSIFL utility, 3-6 RMSDSP utility, 5-3 
Exception records RMSIFL utility, 3-3 
RMSIFL utility, 3-5 to 3-6, RMSRST utility, 7-3 
3-10 
EXIT command IFLA.TMP (RMSIFL), 3-11 
RMSDES utility, 2-3, 2-9, allocating space, 3-13 
2-18, 2-27 IFLAL.TMP (RMSIFL), 3-12 
EXTENSION allocating space, 3-14 
RMSDES utility IFLP.TMP (RMSIFL), 3-10 
area section, 2-45 allocating space, 3-13 
file section, 2-32 INDEX AREA 
External files (RMSDES) RMSDES utility, 2-41 
See Data file, Description file INDEX FILL 
RMSDES utility, 2-41 
File attributes (RMSDES) Indirect command file 
See Attributes RMSBCK utility, 6-2 
File attributes (RMSDSP) RMSCNV utility, 4-4 
indexed file RMSDES utility, 2-3 
detailed display, 5-4 comments, 2-4 
File back-up date RMSDSP utility, 5-2 
See Back-up date RMSIFL utility, 3-2 
File contiguity RMSRST utility, 7-2 
See Contiguity Infile 
File creation (RMSDEF), A-19 RMSBCK utility, 6-3 
File creation date RMSCNV utility, 4-5 
See Creation date RMSDSP utility, 5-3 
File organization RMSIFL utility, 3-3 
RMSDEF utility, A-8 RMSRST utility, 7-3 


FILE PLACEMENT Input file switches 


RMSDES utility, 2-30 RMSBCK utility, 6-8 
File revision date RMSIFL utility, 3-7 
See Revision date RMSRST utility, 7-8 


File space (RMSIFL) 
calculating, 3-12 
File specification 


Interactive utility 
RMSDES utility, 2-1 


Intersystem file transfer, 1-2, 


RMSBCK utility, 6-9 6-1 

RMSDEF utility, A-7 RMSCNV utility, 4-1 
RMSRST utility, 7-10 RMSRST 

See also Infile, Outfile 7/ER switch, 7-7 


Fill numbers 
RMSCNV utility, 4-10 
RMSDEF utility, A-16 


RMSRST utility, 7-1, 7-10 
file-version number 
conversion, 7-5 


RMSIFL utility, 3-6 Invoking 
Fixed control area RMSBCK utility, 6-2 
RMSDEF utility, A-8 RMSCNV utility, 4-3 
FORMAT RMSDEF utility, A-5 
RMSDES utility, 2-36 RMSDES utility, 2-2 
RMSDSP utility, 5-2 
GET command RMSIFL utility, 3-2 
RMSDES utility, 2-10, 2-17, RMSRST utility, 7-2 


Index-4 


Key information 
displaying, 5-4 


Key name 
RMSCNV 


utility, 4-10 


Key of reference 


RMSIFL 
Keys 
RMSDES 


numbering, 2-28, 2-38 


10, 
utility, 3-8 to 


utility 
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explicit/implicit file-spec, 
6-9 
extended diagnostic messages, 
6-10 
summary listing, 6-10 
RMSCNV utility, 4-14 
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3-12 
command string, 3-2 to 3-3 
examples, 3-14 
global switch, 3-5 
HELP, 3-3 
indirect command file, 3-2 
input file switches, 3-7 
invoking, 3-2 
messages, C-l 
output file switches, 
processing, 3-9 
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3-12 
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3-9 
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reading and sorting input, 
3-9 
sorting alternate key files, 
3-11 
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sort work files, 
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processing, 7-9 
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explicit/implicit 
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prompt, 7-2 
query mode, 7-6 to 7-8, 
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key segments, 2-41 
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system section, 2-29 to 2-30 
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SHOW command 
RMSDES utility, 2-15, 2-18, 
2-26 
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PROTECTION attribute, 2-33 
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RMSDES utility, 2-16 
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Sort work files (RMSIFL), 3-1, 
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work files, 3-7, 3-13 
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Summary listing 

RMSBCK utility, 6-10 

RMSCNV utility, 4-12 

RMSRST utility, 7-12 
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